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The following paragraph does not apply to the United Kingdom or any country where such provisions are in- 
consistent with local law : INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS 
PUBLICATION" AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE .Some states do not allow disclaimer of express or implied war- 
ranties in certain transactions, therefore, this statement may not apply to you . 

This publication could include technical inaccuracies or typographical errors . Changes are periodically made to 
the information herein; these changes will be incorporated in new editions of the publication . IBM may make 
improvements and^ or changes in the product (s) and/ or the program (s) described in this publication at any 
time . 

It is possible that this publication may contain reference to, or information about, IBM products (machines and 
programs) , programming, or services that are not announced in your country . Such references or information 
must not be construed to mean that IBM intends to announce such IBM products, programming, or services in 
your country . 

Requests for technical information about IBM products should be made to your IBM authorized reseller or IBM 
marketing representative . 

COPYRIGHT LICENSE: This publication contains printed sample application programs in source language, 
which illustrate 2 programming techniques .You may copy, modify, and distribute these sample programs 
in any form without payment to IBM , for the purposes of developing, using, marketing or distributing applica- 
tion programs conforming to the OS^ 2 application programming interface . 



Each copy of any portion of these sample programs or any derivative work , which is distributed to others, 
must include a copyright notice as follows? 命 （your company name) (year) . All rights reserved" • 

^Copyright International Business Machines Corporation 1994 .All rights reserved . 

Note to U S .Government Users - Documentation related to restricted rights - Use, duplication or disclosure is 
subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp . 
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,□ □ 

M □ 

s □ 
(s n 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 



J o o 

u □ □ 
u □ □ 



□ □ 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
m nn 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

□ m 

□ □ 

nn H 



□ □ 
□ □ 
□ □ 

□ ,□ 

IO D 

T 

A □ 
□ □ 
□ □ 
□ □ 



□ □ 



□ □ 



□ □ 
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□□□□□□□□□□□□□□□ MO □□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□ 〇 s^2DDDDDDDD 



□ 1-1 □□□□□□□□□□□□□ 



□ □□□□□□ 


05 2〇 □ □ 


□ □ □ 


□ □ □ □ □ 


□ □ □ □ □ 


命 


ampmix 


MCI. DEYTYPE. AUDIO. AMPMIX 


□ □ □ □ 




audiotape 


MCI. DEYTYPE. AUDIO. TAPE 


CD □ □ □ □ □ 


命 


cdaudio 


MCI. DEYTYPE. CD. AUDIO 


CD-XA □ □ □ 


命 


cdxa 


MCI- DEYTYPE - CDXA 


□ □□□□□ 




dat 


MCI. DEYTYPE. DAT 


□ □□□□□ 


命 


digitalvideo 


MCI. DEVTYPE. DIGITAL. VIDEO 


□ □ 




headphone 


MCI- DEVTYPE- HEADPHONE 


□ □ □ 




microphone 


MCI. DEVTYPE. MICROPHONE 


□ □ □ 




monitor 


MCI- DEVTYPE- MONITOR 


□ □ 




other 


MCI. DEVTYPE. OTHER 


□ □ □ □ 




videooverlay 


MCI. DEVTYPE. OVERLAY 


□ □□□□□ 




sequencer 


MCI. DEVTYPE. SEQUENCER 


□ □ □ 




speaker 


MCI. DEVTYPE. SPEAKER 


□ □ □ □ □ 


命 


videodisc 


MCI- DEVTYPE- VIDEODISC 


□ □ □ 




videotape 


MCI. DEYTYPE. VIDEOTAPE 


□ □□□□□□ 


命 


waveaudio 


MCI. DEVTYPE. WAVEFORM. AUDIO 



□ □ : M- Control Program Version 2 .01 [] [] M-Motion Video Adapted A,[] [] [] OS^ 2 

□ □□□□□□□ 



13 □□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ MDM, □ 

□ □□□□□□□□□□□□；□□□□□□□□□□□□□□ (MCD) —— □ □ □ □ □ 

□ □□□□□□□□□□ 1-3 □□□ 

□ □ □ (mciSendCommand)] □ □ □ □ □ (mciSendString)D □ □ MCD □ □ □ □ □ □ 

□ □，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 












□ 1-3 □□□□□□□□□ 

mcdq 

□ □□□□□□□□□ MCD □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□，□□ CI>Audi 〇 D □ □ □ 

□ (DAC) ，□□□□□□□□ IOCtl □□ [ 

□ □□□□□□□□□□□□□，□□ CI> Audio □□□□□□ 
(DSP)Q □□□□□□□，□□□□□□□□□ DSP □□□□□□ 

□ □□□□□□□□□ 

mcd □□□□□□□□□□□□□□□□□□,□□□□□[ 

□ □□□□□□□，□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□ 



i4 r 〇 □□□□□ □ 

□ □□□□□□ (MMIO)D □ □ □ 1/ 〇 U CODEC □□□□ □ 

□ □□□□□□□□，□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□ MMIO □□□□□□□□ MMIO □□□□□□□ 

□ □□□□□□□□□□□□ ,mmi 〇 d □□□□□□□□□□□ 

□ VOOO, □□□□□□□□□□□□□□□□□□□□□,” 
□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□a 

□□□□□□□□□□□□□□□□□□』〇□□□□□□□□[ 



□□□□□□□□□ 

□ □□□□, MCD □ 

□ □ □ CD-ROM □ □ 

□ □□□□□□，□ 

□ □□□□□□□□ 

□ □□□□□□□□ 

□ (SPI)D □ □ □ □ 
□ ,□□□□□□□□ 



□□□□□□□□□ 
□ □ mmiod □ □ □ 

□□□□□□□□□ 
) □ □ □ □ MMIO □ 

],]/〇□□□□□□ 

]□□□□□,□□□ 
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□ □□□□□□□□□□□□ CODEC(D □/□□)□□□□ 1-4Q □ □ □ □ MMIO 

□ □□]/0□ CODEC □□□□□□□□□□ 



□ □ □ □ □ 
□ □ □ ，□ 
□ □ □ □ □ 
2Q □ □ □ 
□ □ □ □ □ 

□ □ □ □ □ 
□ )□ AI> 
□ □ SPI □ 



□ 1-4 □ D □ 1/ 0(MMI0)D □ D □ □ 

MMIO □□□□□□□□□□： 

1 •□ □ □ 

□ □□□□□□□□□□□□□□□□ !/〇□□，□□□□□□□□□□□□□ 

□ ,□□□□□□ Dmidid 

□ □□□□□□□□□□□□ !/〇□□，□□□□□□□□□□□□□□□□□ 

2 - □ □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ ^ 〇 DDDDD 

□ □□□，□□□□□□□□□□□□□□ 

3. □□/□□□□□ (CODEC) 

CODEC □ □□□□□□□□□□□□□□□□□□□□□□□,!/ 〇 □□□□□□ 
CODEC □□□□□□□□□□□□□□ 



] D 

□ ] □ 
] D 

□ ) □ 



□ 



□ D 
] D 
)D P □ 



□ 



□ 



□ 



3 □ □ 
□ 



(□ □ 



□ 

□ 

□ 

□ 

5 



□ 

□ 



□ 

□ 



□ 
□ 
□ 
□ 
□ o 



□ 



□ □ 

□ □ □ 

□ □ □ 

□ □ □ 


□ n 
□ ] [ 

□ □ 



□ r 



^ □ 
□ 

□ □ 

3 

□ 

□ □ 
□ 
□ 
□ 
□ 
□ 



o 



□ 

/IV 



□ 

□ 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ □ 

□ □ □ 
□ □ □ 
□ □ 
□ □ 



□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

□ □ 

□ ， 

L， □ 
L □ 
D □ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

nn 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ 

□ 



□ ， 

□ n 

□ n 

□ n 

□ n 

□ n 

□ n 

/IV 

I n 
ID n 
M n 

□ n 
, n 



□ 

□ 

□ 

□ 

□ 

□ 

□ 



n 

n 

n 

n 

n 

n 

n 

□ ) 

□ n 

□ n 

□ n 

□ n 

□ n 

□ n 
， n 

□ n 

□ n 

□ n 

□ n 

□ ( 

□ M 

c 

□ p 




□ 1-5 □□/□□□□□□ 

□ □□□□□□□□□ spi spi □□□□□□□□□ 

□ □,□□□□□□□ ^ 〇 DDD, □□□□□□□□□□□ 
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□ 2〇 □□□□□□□□ 



□ □□□□□□□ (Media Control Driver □□□ MCD)[] □□□□□□□□□□□ 

□ □ □ MCD □□□□□，□□□□□□□□□□□ MCDD □□□□□□□□□□□□ 

□ □□□□□□□□ (Duet Player) Q □ □ □ MCD(Q 〇〇〇 ^2 〇〇〇〇〇〇〇〇〇〇 

□ □□□)□□□□□ mcdd □ spid □□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□ CD □□ MCD CD □□ 

□ □□□□□□□□□□□□(□□□□□□□□□□□，□□□□□□ CPU ) 口 

□ \ TOOLKIT \ SAMPLES \ MM □□□□，□□□□□□□□□□□□□□□□ 

□ □ □ □ □ 

1. □□□□□□□□□□ (MCDTEMP) 

□ □□□□□□ MCD □□□□□□□□□□□□□□□ MMIO 

□ ADMCT □ CDMCIDRVD 

2. □□□□□□□□□□□□ (ADMCT) 

□ □□□□□□□□□□□□□□□□□□□□□□□□ 〇 ^2DDDDDD/D 

□ □□ (Synd Stream Manager □□□ SSM) □□□□□□□□□□□□□□□□□□ 

□ □□□□□ PM □□□□□□□□□□□□ (Media Device Manager,!] □□ MDM )〇 

□ □□□□□□□□□□□□， MDM □□□□□□ MCD, □□□□□□□□□□□□ 

□ □□□□(□)□□□□□□□□(□□)□□□□□□ 

3. CD □□□□□□□□ (CDMCIDRV) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□ ^ OS/2DDDD SSM □ □ □ □ 

□ CD-ROM □ □□□□□□□□□□□,□ CDDD MCD 

□ □□□□□ PLAY, PAUSE, □ STOP：] CD-ROM □□□□□□□□ IOCtls 

□ □□□□□□□□□□□□，□□□□□□□□ 

21 □□□□□□□□□□□□□ 

□ □□□□□□□□ mciSendCommand □□ mciSendString □□□□□□□□□，□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ OS/2DDDDD 

□ (DDL) ，□□□□□□□□□□□□□□□□□□□□;□□□□□□□□ (MDM) □ 

□ □□□□ MCD □□□□□□, MDM □□□□□□□□□□□□□□□,□□□□□□ 





□ □□□□□□□□□□ MCD □□□□□□□□□□□□□ MCDD 

□ 2-idddd 0S/2DDDDDDDD mcd 〇 



□ 2-1 □□□□□□□□ (MCD)D □ □ □ □ 



2.2 □□□□□□□□□□□□ 

□ □ □ MCD □□□□□□□□□□□□□□，□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□ mciSendCommand □ mciSendString □□□□□□□□ MCD 

□ □ □ □ mciDriverEntryO MDM □□□□□□□□□ 

□ □□□□□□□□□□□□□□□□ 

□ 2-1 Q Q Q mciDriver Entry Q □ □ □ □ □ 
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□ 2-1 □□□□□□□□□□□□ 



□ □ 


























□ 


□ 


PVO ID pin stance 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


□ □ □ 


USHORT usMessage 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 














ULONG ulParaml 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


□ □ □ □ 


PVOID pParam2 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


,□□□□□□□□□□□□□ 


USHORT usUserParm 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 





mciDriverEntry □□□□□□□□□□□□□□□□□□□□□□，□□□ MCI — 
OPEN □□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□ 

1. □□□□□□□□□□□□□□□□□□ 

2 . □□□□□□□□□□□□□□□□□□□□□□□□□□□ ，□□□□□□□ 

□ □ □ □ □ MCD,Q □□□□□□□□□□□□□□□□□□□□ 

3 - □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□： 

(1) CD-ROM XAD □ 

(2) CDQ □ □ □ 

〇)□□□□□□ 

(4) MIDID □ □ 

( 5 ) □ □ □ □ □ □ 

( 6 ) □ □ □ □ □ □ 

( 7 ) □ □ □ □ 

MDM □□□□□□□□□□□□□□□□□，□□□□，□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□ 
□ □ 

□ □□□□□□□□□□□□□□□□□ 

23 □□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□ MCD □□□□□□ 

□ □□□□□□□□□□□□□□□□，□□□□ MCD □□□ MCD □□□□□□□□ 

□ □□□□□□□□[□□□□□□□□□□□□□a 

231 □□□□□□ 

□ 2-2 □□ 
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□ □ □ MCD □□□□□□□□□□□□ 



□ 2-2 □□□□□□ 



□ □ 


□ □ 


MCI. CLOSE 


□ □ □ □ □ 


MCI- GETDEVCAPS 


□ □□□□□□□ 


MCI. INFO 


□ □□□□□□□□□ 


MCI. OPEN 


□ □□□□□□□□□□ 


MCI. STATUS 


□ □□□□□□□□□ 


MCIDRV. SAVE 


MDM □ MCD □□□□□□□□□□□ 


MCIDRV. RESTORE 


MDM □ MCD □□□□ ,□□□□□□□□□□□□□□□□ 



□ □□□□□□□□□ ULONG □□ ulParaml □□,□□□□□□□□□□□□, 

□ □□ pParam2 □□□□□□□□□□□□□□□□□□□□ MCD □□□□□□□□ 

□ □，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ MCD □ □□□□□□□□□□□□□□□□□□□□□□ 

□ 2-3 □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□，□□ Cm 〇 S/2[] □□□□□ □□□ 



□ 2-3 



□ □ 


□ □ (ulRaiaml) 


□ □ □ □ (pRararC) 


MCI. CLOSE 


MCI. NOTIFY 
MCI. WAIT 


MCI - GENERIC PARMS 


MCI- GETDEVCAPS 


MCI- NOTIFY 
MCI. WAIT 
MCI. STATUS 

MCI. GETDEVCAPS- EXTENDED 
MCI. GETDEVCAPS. MESSAGE 
MCI- GETDEVCAPS- ITEM 


MCI- GETDEVCAPS- PARMS 


MCI. INFO 


MCI. NOTIFY 

MCI. WAIT 

MCI. INFO- PRODUCT 


MCI. INFO. PARMS 


MCI. OPEN 


MCI. WAIT 

MCI- OPEN SHARABLE 
MCI. OPEN ELEMENT 
MCI- OPEN MMIO 


MMDRV— OPEN PARMS 


MCI. STATUS 


MCI. NOTIFY 


MCI. STATUS- PARMS 
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□ □ 



□ □ 


□ □ (ulRaiaml) 


□ □ □ □ (pRaran12) 


MCIDRV - RESTORE 


MCI. WAIT 

MCI. STATUS. CLIPBOARD 
MCI. TRACK 
MCI. STATUS. ITEM 
MCI. WAIT 


MCI - GENERIC PARMS 


MCIDRV- SAVE 


MCI. SHAREABLE 
MCI. EXCLUSIVE 
MCI- WAIT 


MCI - GENERIC PARMS 



2 3 2 □ □ □ □ MCD 

MCI . OPEN □ MCD □□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□ MCD □□□□□□□□□□□□□□□□□□□□□□□, MCI — 
OPEN □□□□□□□□□□□□ 

□ □ MDM □□□□□□□□□□□□，□□□□□ MCD □□□□□□□□ MCI — 
OPEN _ PARMS □□□□□□□, MCD □□□ □ MDM □□□□□□□□□□□□□ 

MCI— OPEN □□□□□□ NOTIFY, □ □ MCD □ □ □ □ MCIDRV . RESTORE □□ □ 

□ □□□□ NOTIFY[] □□□□□□□□□□□ MCD □ MCI — OPEN □□□□□□ □ 

□ □□□□□□□： 

■ MCI OPEN ALIAS 

■ MCI NOTIFY 

■ MCI OPEN TYPE. ID 

□ MCI — OPEN □□□ ,pParam2 □□□□□□ MMDRV - OPEN — PARM,[] □□ □ 
□ □ □ □ MMDRVOS2 -H □□□□□□□□□ MCD □□□□□□□□ 2-4 □□ 



□ 2-4 MMDRV. OPEN. PARM □ □ 



□ □ 




' □ □ 














□ 


□ 














HWND hwndCallback 


□ 


□ 


□ 


□ 


mciDriverNotify □ □ □ □ □ □ 










USHORT usDevicelD 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


ID □ □ □ □ 


□ □ 


□ 


MDM 〇 


□ 


□ □ 


USHORT usDeviceType 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ □ 
















USHORT usDeviceOrd 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ 
















PVOID plnstance 


□ □ 


□ □ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ □ □ 


□ □ 


□ 


□ □ 


□ 


□ 


□ 


□ □ □ 








□ 


□ 


□ 


□ 


□ 


□ 


















CHAR szDevDLLName [260] 


□ 


□ 


□ 


□ 


□ 


，□□□□□□□□ 


□ □ 


□ 


□ □ 


□ 


□ 


□ 


DLL 〇 








□ 


□ 


□ 
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□ □ 



□ □ 




□ □ 


PSZ pszElementName 

USHORT usDevParmLen 
PVOID pDevParm 


□ □ 

□ □ 
□ □ 


□□□□□□□□□□□□□□□ OPEN 
PLAYLIST, □ □□□□□□□□□□□□□□□□ 

□ □□□□□ 〇 PEN_ MMIO,Q □ □ □ MMIOQ □ □ 

□ □□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□,□□□ 

□ □ MMPM2 .INI □□□□(□□, LVD' PORT = 
COM1 SPEED =9600N71 ,, )D 


USHORT us Resource Units Required 


□ □ □ □ 


□ □□□□□□□□□□□,□□□ 2 .9 『□□□□ 
□□□□"□ 


USHORT us Resourced ass 


□ □ □ □ 


□ □” 口 


USHORT usResourcePriority 
ULONG ulParam2 


□ □ □ □ 
□ □ 


□□□□□□□□□□ 

□ □ MCI- OPEN □ □ □ 



2 . 3 . 3 □ □ □ □ □ 

MDM □□□□□□□□ MCD □□□□□□： 

■ MCIDRV. SAVE 

■ MCIDRV - RESTORE 

MCIDRV - RESTORE □ MCIDRV . SAVE □ MDM □□□□ MCD □□□□□□ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□ MCI. WAITQ □ □ 
MDM □□□□□□□，□□□□□□□ MCD □□□□□□□□□□□ MCIDRV . 
SAVE □ MCIDRV - RESTORE □□□□□□□□□□□□□□ 

□ □□ MCI — OPEN □□□□, MDM □ MCD □□□ MCIDRV - RESTORE □ 

□ □□□□□□□□ MCD □□□□□□□□ MCI — OPEN □□□□□□ □ MCIDRV . 
RESTORE □□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□ 

□ MDM □ 

□ □□□□□□□□□□□□□□□□□□□□, MCD □□□□□□□□□□□□□ 
□，□□□□ MCIDRV. RESTORED 

MDM □ MCD □ □ □ MCIDRV . SAVE □□□□□□□□□□□□□□□□□ 

mcdq 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□， 
□ □□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□： 

■ MCI. CLOSE 
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■ MCI INFO 

■ MCI. STATUS 

■ MCI GETDEV CAPS 

mcdq □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□,□□ 

□ □□□□□□□□ 

□ MCIDRV . RESTORE □ MCIDRV . SAVE □□□□□,□□□0 没 2[] □ 

2 3 4 □ □ (Wait)n □ □ (Notify)D □ 

MCI. WAIT □ □□□□□□□□□□□□□□，□□□□□□□□□□□□□□ 

□ □，□□□□□□□□□□□□□ 

MCI — NOTIFY □□,□□□□□□□□□，□□□□ mdmDriverNotify □□□□ □ 

□ □□□□□□□□□□□□□□□□ (Notify)D □ ,□ MCD □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□ MCI- WAIT, □□□□□ MCI — NOTIFY, □ □□□□□□□□ 
MCI— NOTIFY □□□□,□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□ MCD □ □ SSM □□□，□□□□□□□□□□□□□□ 

□ □ □ 

□ □□□ mciDriverEntry mdmDriverNotify 

□ □□□ mciDriverEntry □□□□□□□□□, MCD □□□□□□□□□□□□□ 

□ □□□□□□, MCD □□□□□□□□□□□□□，□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□, MCI — PLAY □□□ hwndCallback ulFrom □ 
ulTo □□,□□□□ MCI— NOTIFY □ □□□□□□□□□ 

MCI. PLAY, MCI RECORD, MCI SEEK □ MCI — STEP □□□□□□□□□□□ 

□ □□□□□□□，□□□□□□□□□□□□ MCI PAUSE, MCI GETDEVCAPS, 
MCI - STATUS □ MCI』 SET □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□，□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□ 

D D D D D mdmDriverNotifyO 

Q D MCD D □□□□□□ (Stream Programming Interface, 〇 〇 〇 SPI )〇 □ □ □ □ 

□ spi □□□□□□□□□□□ spi □□□□□□□□□□□ SPIDD,DD 

□ □□[□□□□□ SPI □□□□□□□□□□□□□□□□□□□□ , mdmDriverNotify 

□ □□□□□□□□□□□□□□□ 
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□ □ MM- MCINOTIFY □□□□□□□□□□□□□□□□,□□ 2-5 □□□ 

□ 2-5 MM. MCINOTIFYD □ □ □ □ □ 



□ □ □ 




















□ □ □ □ 


□ 




MCI. NOTIFY. 


SUCCESSFUL 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


，口 D 


□ □ 






MCI- NOTIFY- 


SUPERSEDED 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ □ □ 


□□□□□□□□ 


□ □ 


MCI- NOTIFY- 


ABORTED 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


,D 


□ □ □ □ 


□□□□□□□□ 


□ □ □ 






□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □□口 


□□□□□□□□ 


□，口 






I 


H 


n 


n 


n 


n 


n 


H 


IL 


,n n n n 


n n n n n n n _ 





□ □ MM _ MCINOTIFY □□□□□□□□□□□□ 2-5 □,□□□□□□□□ 
OS/ 2 〇 □□□□□□□□□□□□□□□□□□□□□□ MM - MCINOTIFY □□ □ 

235 □□□□□□ 



□ ,□□□□□□□□□ play □□□,□□□□□□□□□□□□□□□□□□□□ 

□ □□□ CD □□□□□□, □□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□ 2-6 □□□□□□□□□□□□□□□□□□□□，□□□□ 
MCIERR — UNSUPPORTED — FUNCTION：] 

□，□□□□□□□□□□□□ MCIERR — UNSUPPORTED - FLAGD 



□ 2-6 □□□□□□□□□□□ 



□ □ 


□ □ 


MCI. CONNECTOR 


□ □mamnDDDDDDDDDD 


MCI. LOAD 


□ □□□□□□(□□□)□□□□□□□□□□□□ 


MCI- MASTERAUDIO 


□ □□□□□□□□□□□□□□□□□□ MCI- MASTERAU- 




DIO □□□□□□□□, □□□□□□□□□□□□□□□□□ 




□□□□□□ 


MCI. PAUSE 


□□□□□□□□ 


MCI. PLAY 


□□□□□□□□ 


MCI. RECORD 


□□□□□□□ 


MCI. RESUME 


□ □□□□□□□□□□□□ 


MCI. SAVE 


□□□□□□□□ 


MCI- SEEK 


□ □□□□□□□□□□□□ 


MCI. SET 


□□□□□□□□□□ 


MCI- SETCUEPOINT 


□□□□□□ 


MCI- SETPOSITIONADYISE 


□ □□□□□□□□□□□ 


MCI. STATUS 


□ □□□□□□□□□□□□□□ 


MCI. STOP 


□ □ □ □ □ 


□ □□□□□□□ ulParaml □□□□□□□□□□□□□□□□□□□□□ pPa- 



mm2 □□□□□□□□□□□□□□□□□□ MCD □□□□□□□□□□□□□□□ 
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□ □□□□□□□□□□□□□,□□ mcdd □□□□□□□□□□□□□□□ 

□ 2-7 □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ [m 〇 S/2[| □□□□□□□□□ □ 



□ 2-7 



□ □ 


□ □ (ulPararil) 


□ □ □ □ (pParanC) 


MCI- CONNEC- 
TOR 


MCI. NOTIFY 
MCI. WAIT 

MCI. ENABLE. CONNECTOR 
MCI. DISABLE. CONNECTOR 
MCI. QUERY. CONNECTOR. STATUS 
MCI- CONNECTOR _ TYPE 
MCI- CONNECTOR - INDEX 


MCI. CONNECTOR. PARMS 


MCI. LOAD 


MCI. OPEN ELEMENT 
MCI. OPEN MMIO 
MCI- NOTIFY 
MCI. WAIT 


MCI - LOAD PARMS 


MCI- MASTER- 
AUDIO 


MCI- WAIT 

MCI. QUERYCURRENTSETTING 

MCI. QUERYSAVEDSETTING 

MCI- SAVESETTING 

MCI. MASTERVOL 

MCI. SPEAKERS 

MCI. HEADPHONES 

MCI. ON 

MCI. OFF 


MCI - MASTERAUDIO- PARMS 


MCI. PAUSE 


MCI. NOTIFY 
MCI- WAIT 


MCI. GENERIC. PARMS 


MCI. PLAY 


MCI. NOTIFY 
MCI. WAIT 
MCI- FROM 
MCI. TO 


MCI - PLAY _ PARMS 


MCI. RECORD 


MCI. NOTIFY 
MCI. WAIT 
MCI. FROM 
MCI. TO 

MCI. RECORD. INSERT 
MCI. RECORD. OVERWRITE 


MCI - RECORD PARMS 


MCI. RESUME 


MCI. NOTIFY 
MCI. WAIT 


MCI. GENERIC. PARMS 


MCI- SAVE 


MCI- NOTIFY 


MCI - SAVE PARMS 
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□ □ (ulPararil) 



□ □ □ □ 



MCI. SEEK 



MCI. SET 



MCI- SETCU& 
POINT 



MCI- SETPOSI- 
TIONADYISE 



MCI. STATUS 



MCI. WAIT 
MCI- SAVE- FILE 
MCI. NOTIFY 
MCI. WAIT 
MCI- TO 

MCI. TO. START 

MCI. TO. END 

MCI. NOTIFY 

MCI. WAIT 

MCI. SET. AUDIO 

MCI. SET. DOOR. OPEN 

MCI. SET. DOOR. CLOSED 

MCI. SET. DOOR. LOCK 

MCI- SET _ DOOR— UNLOCK 

MCI- SET- VOLUME 

MCI. OYER 

MCI. SET. VIDEO 

MCI- SET- ON 

MCI. SET. OFF 

MCI. SET. SPEED FORMAT 

MCI. SET. TIME. FORMAT 

MCI. SET. ITEM 

MCI- NOTIFY 

MCI. WAIT 

MCI. SET. CUEPOINT. ON 
MCI. SET. CUEPOINT- OFF 
MCI. NOTIFY 

MCI. WAIT 

MCI. SET. POSITION ADVISE. ON 

MCI. SET _ POSITION ADVISE. OFF 

MCI. NOTIFY 

MCI. WAIT 

MCI. STATUS. START 

MCI. TRACK 

MCI- STATUS- ITEM 

MCI. NOTIFY 

MCI. WAIT 



MCI. SEEK PARMS 



MCI. SET. P ARMS 



MCI - CUEPOINT PARMS 



MCI. POSITION PARMS 



MCI. STATUS. PARMS 



MCI. STOP 



MCI. GENERIC. PARMS 










236 □□□□□□ 

□ □□□□□□□□□□□□□ (MDM)Q □，□□□□ MCD 〇 □ 2-8 □□ □ MDM 

□ □□□□□□□ 



□ 2-8 □ □ □ □ 



□ □ 


























□ 




□ 


MCI- ACQUIRED EV ICE 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 






MCI. CONNECTION 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


□ 


MCI- CONNECTORINFO 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 






MCI- DEFAULTCONNECTION 


□ 


□ 




1 □ □ 


MCI. GROUP 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


□ 


MCI- MASTERAUDIO 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


，口 [ 


1 □ 1 


]□□□□□□□□□□□□ 




□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 






MCI- SYSINFO 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 




MCI- RELEASEDEVICE 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


□ 



2 3 7 □ □ □ □ 

□ □ □ MCD □□□□□□□□□□□□□□，□□□□□□□□□□□□□□□ 

□ □□□□□□□□□ mciSendCommand □ mciSendString □□□□□□□□ MCD □ □ 

□ □ mciDriverEntryO □□,□□□□□□ MDM □□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□ 
□ □□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□ 

□ □ □ MDM □□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□ 

2-9 〇 



□ 


2-9 MCD □□□□□□□ 




□ MDM □ □ 


□ □ □ □ MCD 


CD 〇 □ MCD 


MCI- SET □□□□□□□□□ 


□□□□□□□□□□□ 


□ □ iocti □□□□□□ 


□ □□□□□□(□, SEEK, 


□ □ □ □ □ SSM 口 


□ □ iocti □□□□□□ 


PLAY, PAUSE, STOP) 







238 □□□□□ 

□ □□□□□□□□□□ MCD □□□□□□□□□□ MCD □□□□□□□□□ 
□ □□□□ 2-10 □□□□□□□□□□□□□□□□ 
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□ 2-10 □□□□□□□□□□□□□□ 



□□□□□□□□ 


□□□□□□□□ 


□□□□□□□□ 


MCIERR. OUTOFRANGE 


□ □ □ usMessage □ 


MCIERR- UNRECOGNIZED- COMMAND 


□ □ □ ulParaml □ 


MCIERR, INVALID. FLAG 


ulltem □□□□□□□□ 


MCIERR, INVALID. ITEM FLAG 


ulTimeFormat □□□□□□□□ 


MCIERR- INVALID- TIME- FORMAT- FLAG 


ulSpeedFormat □□□□□□□□ 


MCIERR- SPEED FORMAT- FLAG 


□ □ □ □ □ (NULL)Q pParam2Q Q 


MCIERR. MISSING - PARAMETER 


pParam2 □□□□□□□□□□□ 


MCIERR, INVLID BUFFER 


□ □□□□□□□□□□□□□□, ulParaml □ 


MCIERR. MISSLNG- FLAG 


□ □ □ □ 




ulParaml □□□□□□□□□□□□□ ,□□□ 


MCIERR. UNSUPPORTED. FLAG 


□ □□□□□□□□ 




usMessage 〇 □□□□□□ ,□□□□□□□ ,□ 


MCIERR. UNSUPPORTED. FUNCTION 


□ □□□□□□ 




nnn 门 nn 门 n 门门 nnnn 


MCIERR. FLAGS. NOT. COMPATIBLE 



□ □□□□□□□ mdm □ □ □ : 

■ □□□□ MCI— NOTIFY □ □□,□□□□□□□□□□□□□□□□ 
■□□□□□ MCI — WAIT □ MCI — NOTIFY □□ □ 

' □□□□□□□□□□□□□ 

239 □□□□□□□□ 

MCD □□□□□□□□ MCIERR □□□□□□□□□□ (：□□□ MEERROR .H 

□ □□□□□ SPI,MMIO □□□□□□□□□□□□□□□□□□□ MCIERR □ □ 

□ ,□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□ 

□ □ MCIERR- CUSTOM - DRIVER^ BASE □ MEBASE. !□□□□□□□□□□□□ 

□ □□□□□□□□□□，□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□, MCD □□□□□□□□□□□□□ 2-11 □ □ □ □ 

□ □ 



□ 2 11 □ □ □ □ 



□ □ □ □ 










□ 






□ 




MCI. INTEGER. RETURENED 


□ 


□ 


□ 


□ □ 


□ □ 


□ 


□ 


□ 


□ □□□□□ 




ASCII □ □ [ 


] □ □ 


□ 








MCI- COLONIZED2. RETURN 


□ 


□ 


□ 


□ □ 


□ □ □ 


□ 


□ 


□ 


□ ： 




byte 


0: 


byte 


2 










MCI- COLONIZED3. RETURN 


□ 


□ 


□ 


□ □ 


□ □ □ 


□ 


□ 


□ 


□ ： 




byte 


0 


byte 


I byte 


： 2 








MCI- COLONIZE D4. RETURN 


□ 


□ 


□ 


□ □ 


□ □ □ 


□ 


□ 


□ 


□ ： 
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□ □ □ □ 

MCI. TRUE. FALSE. RETURN 
MCI. DE VICENAME. RETURN 
MCI. SPEED. FORMAT. RETURN 
MCI. TIME. FORMAT. RETURN 
MCI. MEDIA. TYPE. RETURN 

MCI. TRACK. TYPE. RETURN 

MCI. CONNECTOR. TYPE. RETURN 

MCI. CDXA. CHANNEL. DESTINATION RETURN 

MCI. PREROLL- TYPE. RETURN 
MCI- FORMAT- TAG- RETURN 

MCI. SIGNED. INTERER. RETURN 



□ □ 



byte 0 byte I byte 2 byte 4 

□ TURH FALSE □□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□ 

□ □□□□□□□□" CLV”，" CAV ，，， 

' OTHER "〇 

□ □□□□□□□□" AUDIO” DATA ，，， 

' OTHER" □ 

□ □□□□□□□□□□□□□□□□ 

□ CDXA □□□□□□□□□□□□□ 

□ □ □ □ □ 

□ □□□□□□□□□□□□□□□□ 

□ □ □ □ □ (tag)D □□□□□□□□□ 

□ □ □ 

□ □□□□□□□□□□□□□□□ 
ASCII □□□□□□ 



□ 2-11 □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□ mciSendString □□□□□□□□□□□□□□□□□,□□□ 

□ □□□:" capability cdaudio has video" □ □ mciSendString □□□□□□□□□□ 
FALSED CD □ □ MCD □□□□□□□□ MCI GETDEVCAPS- PARMS □ □ □ ul- 
Return[] □□□□，□□ MCI— TRUE. FALSE— RETURN □□□□□□□□□□ 

24 □□□□□□□□ 

□□□□□□□□□□□□□□□□ 4〇〇〇〇〇〇〇〇〇〇〇〇〇〇〇〇〇〇： 

!•□□□□□□□□□□□□□□□□□□□□□□□□□□□□□(□□ 2.4.1 

2 . □□□□□□□□□□□□□□□□□(□□ 2. 4 2 □»□□□□□□□□□□ 

3. □□□□□□□□□□□□□□□, MDM □□□□□□□□ mciSendString □ □ 

□ □□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□(□□ 

2.5 2DDDDDDDDDD T) 

4 .□□□ MCD □□□□ (mciDriver Entry )□ □□□□□□□□ 

241 □□□□□□ 



□ □□□□□□□□□□□□□ MCD □□□□□□□□ (reset) □ □,□□□□□ 
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□ □□□□ reset program - number □□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□，□□ program — number □□□□□□□□□□□□□ 

□ □□ mciDriverEntry □□□□□□□□□□□□□□□□: 

# define MCI. VD. RESET MCI _ USER. MESSAGES 



MCI- USER- MESSAGE □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ □ RCDATA □□□□□□□□□□□，□□□□□□□□□□□□□□□□ 

□ □ 

□ □,□□□□□□□□□□□□ ID □□□□□□□□□□□□□□□□□□□ 

□ mciDriverEntry □ □□□□□□□□□□□□□□□□ 

242 □□□□□□□□□□□ 

□□□□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□ 

pParam 2 〇〇〇〇〇〇〇〇〇〇〇,〇〇〇 ulParam !□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□ 

□ □□□□□□□□□ ulParaml □□□□,□□□□□□□□□□□□□□□，□□□ 

□ □□□□□□，□□□□□□□□□□□□□□□□□□□□□□□ 

2421 □□□□□□□□ 

□ □□□□□□□□□□□□□□□□□,□□□□□□ ULONG □□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□ MCI 
NOTIFY □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ 

■ □□□□□□□,□□□□□□□□□□□□□□□□□ mcdq □□□□□□□ 

□ □ □ □ □ hwndCaUbackQ □□□□□□□,□ 2-2 Q Q Q MCI . SAVE _ PARMS 

□ □□，□□□□□□□□ 



typedef struct - MCI- SAVE - PARMS { 

HWND hwndCallback; / * PM window handle for MCI notify message */ 

PSZ pszFileName; / * File name to save data to */ 

} MCI- SAVE- PARMS ； 

typedef MC I - SAVE - PARMS * PMCI - SAVE - PARMS; 



□ 2-2 MCI- SAVE- PARMS □□□□ □ 

□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□ 

□ MCD □□□□□□□□□□□□□□□□□□，□ 2-3 □□□ MCI _ GETDE- 

VCAPS- PARMS ulReturn □□□□□□□□□□ 
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typedef struct - MCI- GETDEVCAPS- PARMS { 

HWND hwndCallback; / * PM window handle for MCI notify message 

ULONG ulReturn; / * Return field 

ULONG ulltem; / * Item field for GETDEVCAPS item to query 

USHORT usMessage; / * Field t 〇 hold MCI message t 〇 query 

USHORT usReservedO; / * Reserved field 

} MCI- GETDEVCAPS- PARMS; 

typedef MCI_ GETDEVCAPS - PARMS * PMCI _ GETDEVCAPS. P ARMS; 



□ 2-3 MCI. GETDEVCAPS- PARMS □ □ □ □ 

□□□□□□□□□□□□，□□□□□□□□□□□□□□□ 

□ □ ULONG □□□□□□□□□ null □□□□□□□□□□ 

LONG □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□ mcd □□□□□□□□□□□□□□□□□□ 

MCI — INFO — PARMS □□，□□□ pszReturn □ ulRetSize □□□ [ 

typedef struct. MCI— INFO. PARMS { 

HV\7ND hwndCallback; / * PM window handle for MCI notify message 

PSZ pszReturn; / * Pointer to return buffer 

ULONG ulRetSize; / * Return buffer size 

} MCI- INFO- PARMS ； 

typedef MCI- INFO- PARMS * PMCI - INFO- PARMS; 



□ 2-4 MCI - INFO - PARMS □ □ □ □ 

□ □□□□□ RECTL □□□,□□□□□□□□□□□□□□ I 

□ □□□□ ULONG □□□□ □ RECTL □□□□□□，□□□ 

□ □ RECTL □□□□□□□□□□ MCD □□□□□□□□□ 

□ □□□□□□，□□□□□□□□□□，□□□ RECTL □ □ 
LONG,D □ □ □ □ □ RECTL □□□□□□□□,□ 2-5 □□ 
RECT— PARMS □□，□□□ rc[] □□□□□ □ 



typedef struct. MCI- VID- RECT_ PARMS { 

HWND hwndCallback; / * PM window handle for MCI notify message */ 

RECTL rc; / * rectangle array specifying the offset */ 

/ * and size of a rectangle */ 

} MCI - VID- RECT- PARMS; 



□ 2-5 MCI— VID. RECT. PARMS □□□ □ 



2422 □□□□ 

□ □□□□□□□□□□□□□□□□□□,□□□□□□□□□ 



□ □□□□□□ 
□ □ □ □ □ U- 

□ □□□□□□ 

, □ 2-4 □□ □ 

] □ □ □ 



]□□□□□□ 
ULONG □ □ □ 

□ □ ULONG □ 

□ □ □ □ □ u- 

□ MCI VID 



□ □□□□□□ 
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□ □ ,MCI— WAIT □□□□□□□□□□□ 

□ □□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□ ULONG 

□ 32 □□,□0□□□ 15 □□□□ MDM □□□□□ 16 □ (OxOOOlOOOO)：] □□□□ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□a 〇 □□ 
□，□□□□□□□□□□□□□□□ 16 □ 20 , □ □□□□□□□□□□□□□□□□ 

□ □□□□□ 21 □ 31 口 

□ □□□□□□□□□□□□□□ RESET □□□□□□□ 2-6 □□□□□□□□ 

□ □□□□□□□□，□□□□□□□，□□□□□□□□□□□□□□□□□□□□ 

typedef struct { 

HWND hwndCallback; 

ULONG ulProgram; 

} MCI - VD_ RESET- PARMS; 

typedef MCI- VD- RESET- PARMS FAR* PMCI - VD- RESET- PARMS; 

# define MCI. VD. RESET. PROGRAM 0x000 10000L 



□ 2-6 □ □ □ □ 

□ □□□□□ ulParaml □□□□ MCI — VD— RESET — PROGRAM □□，□□□□ □ 

□ □□□□□□□ ulProgram 〇 

□ □ □ MDM □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 2. 5 2D 

25 □ □ □ 

□ □□□□□□□□□，□□ MDM □□□□□□□□□□□□□□□□□□□ 
MCDQ □ □ □ □ □ MCD □□□□□□□□□□□□□□□□□□□□□，□□□□□ 

□ □□，□□□ RCDATA □□□□□□□□ RCDATA □□□□□□□□□□□□□ 

□ 2-7 □□□□□□□□□□ (MDM)n mciRx- 



□ 

□ 



D D 

□ □ 

/IV I— 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ □ 
□ □ 
□ □ 

□ M 

□ D 

dm ， 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



D 

□ c 

□ M 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

2 

o 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

M 

D 

M 

□ 

□ 

7 

n 2- 
□ □ 
□ □ 
□ 

□ 



□ n 

□ n 

□ n 

□ n 

□ n 

□ n 

□ ,□ 
□ ) 



D 



n 



c n 

M n 

□ n 

□ n 
n 



□ 

□ 

□ 

□ 

□ 

□ 



n 

n 

n 

n 

n 



n 

□ n 

□ n 
n 
n 

□ n 

□ n 

□ n 

， n 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



n 

/IV 

n 

n 

n 

n 

n 

n 



D 

□ c 

□ M 
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□ 2-8 □□□□□□□□□ SEEK □□口 



□ 2-7 □ □ □ 

□ □□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□，□□□□□□□□□□□□ SEEK 2-8[] □ □ 



〃 1 〃 
seek r 


MCI. SEEK, 0 , 


MCI. COMMAND. HEAD, 


^ notify , 


MCI_ NOTIFY, 


MCI. FLAG, 


wait , 


MCI_ WAIT, 


MCI_ FLAG, 


"to start". 


MCI_ TO- START, 


MCI_ FLAG, 


”t 〇 end: 


MCI- TO- END, 


MCI_ FLAG, 


to r 


MCI- TO, 


MCI- INTEGER, 


" " 

r 


〇 L, 


MCI - END- COMMAND, 



seek ” ， 

"notify" , 

rr . rr 

wait r 
"to start" f 
"'to nearest'" f 



MCI_ SEEK, 0, 

MCI_ NOTIFY, 

MCI_ WAIT, 

MCI- TO _ START, 
MCI- TO- NEAREST, 



MCI_ COMMAND. HEAD, 
MCI _ FLAG, 

MCI _ FLAG, 

MCI _ FLAG, 

MCI - FLAG, 



D □ 

c ) 

M □ 
□ 9n 
□ 2 - 
D 



D □ 

D 

D 

D 

□ □ 

D 

D 

D 

□ □ 
D 
D 

D 

D 

D □ 
D □ 
D □ 

D □ 
] □ 



D [ 

D □ 

Mc ,n 

D 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
,n D 

D □ 
D D 



□ □ 
,□ □ 
□ □ 
□ □ 
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"t 〇 encf , MCI _ TO _ END, 

"to , MCI. TO, 

r 〇 L, 



MCI - FLAG, 

MCI_ INTEGER, 

MCI_ END_ COMMAND, 



□ 2-9 □□□□□□□□□ SEEK □ □ □ 

□ □ □ MCD □ , □ □ DLL 

MMPM2 .INI □□□□□□□□ MCD □ ,MDM □□□ MCD □□□□□□□□□□□ 

□ INI □□□□□□ 5 □ 5 .5 

□ 2- 10 □□□□□□□□□□□□□□□□□□□□ MMPM2 .INI □□□ □ 
MCDTABLE □□□□□ MDM. DLL □□，□□□□□□□□□□□□□□□□□□□ 

□ □□□ VSDT ABLE □□□□□□□□□□□□□□□□□□□□□□□ SVMC .DLL 

□ □ 

MDM □□□□□□□□□□□□□□□□□□□□□ 2- 10 □□ 〇 □□□, MDM 

□ □□□ SVMC DLL □□□□□□□□□□□□，□□□□ MDM DLL □□□□□ □ 

□ □□□□□□□□□□□□□□ (SMVCMD .RC)D □ □ □ □ □ (MDMCMD .RC)Q 

[ ibmdigvid 01 ] 

VERSIONNUMBER = 1 

PRODUCT INFO = SOFTWARE MOTION VIDEO 
MCDDRIVER = SVMC 
VSDDRIVER = AUDIOIF 
PDDNAME = AUDIOlQ 




RESOURCENAME = DIGITALVIDEO 
DEVICEFLAG = 1 
DEVICETYPE = 12 
SHARETYPE = 3 
RESOURCEUNITS: 1 
RESOURCECLASSES =1,1 
VALIDCOMBINATIONS = 
EXTNAMES = 3 , UMB, MMM, V 
ALIASNAME = DV 



□ 2-10 □ MMPM2 .INID □ □ □ □ □ 



251 □□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ ,□ 2-11 □ MCI- OPEN □ MCI. INFO □ □□□□□□□ MDMCMD RC □ □ □ □ 
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□□□□□□□□□□ 



〃 〃 
open r 


MCI _ OPEN, 0, 


MCI_ COMMAND— HEAD, 


〃 〃 

r 


MCI - INTEGER, 


MCI_ RETURN, 


notify , 


MCI - NOTIFY, 


MCI_ FLAG, 


wait r 


MCI _ WAIT, 


MCI_ FLAG, 


’’readonly' 


MCI _ READONLY, 


MCI_ FLAG, 


’’shareable ”， 


MCI - OPEN- SHAREABLE, 


MCI - FLAG, 


type , 


〇 L, 


MCI_ STRING, 


〃 〃 

r 


MCT. OPEN. F.TF.MF.NT, 


MCI_ STRING, 


rr . 〃 

alias , 


MCI - OPEN- ALIAS, 


MCI_ STRING, 


"〃 

r 


〇 L, 


MCI - END- COMMAND, 


info r 


MCI - INFO, 0, 


MCI_ COMMAND— HEAD, 


〃〃 

r 


MCI- STRING, 


MCI_ RETURN, 


^ notify , 


MCI - NOTIFY, 


MCI_ FLAG, 


wait r 


MCI _ WAIT, 


MCI_ FLAG, 


"product ”， 


MCI - INFO- PRODUCT, 


MCI - FLAG, 


"file". 


MCI. INFO- FILE, 


MCI_ FLAG, 


〃 " 

r 


〇 L, 


MCI - END- COMMAND, 



□ 2-11 MDMCMD RC □□ MCI— OPEN □ MCI— INFO □□□ □ 

□ □□□□□□□□□□： 

' □ !□□□□□□□□□，□□□□□□□□□ 

■ □□□□□□□□ 

2511 □ □ □ 

MDM □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ MCI— COMMAND— HEAD □□，□□□□ MCI- END. COMMANDO □ □ 

1 . MCI RETURN 

□ □□□□□□□□□□□□□□□□□MCI — RETURN □□□□□□□□□□ 

□ □ 

■ □ 1 □口" "口 

■ ：□□□□□□□ 

■ □ 3 □ □ MCI - RETURND 

□ □□□□□□□□，□□□□□□□□□ ULONGD □□□□□□，□□□□□ 
ULONG: □□□ ULONG □□□□□□□□□□,□□□ ULONG □□□□□□□□□ 
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□ □ 

□ □□□□□□□ mciSendString □□□ pszReturnString □ usReturnLength □□ □ 
□ □□□□□□□□ 2-11 □□□□□□□□□□□□□ 

MCI - OPEN □□□□ ULONG □□ MCI — INFO □□□□□□□□□□□□□,□ 
□ □□□□□□□□□□□ ULONG □□□□□□□□□□□□□(□□,□□□ U- 
LONG □ □ □ hwndCallback[]) 

2 . MCI RETURN TYPE 

□ □□□□□□□□□□□□□□□□□□□□□□□□□,□□ 2-12Q 



"" 

r 


MCI - TRUE — FALSE . RETURN, 0 , 


MCI_ RETURN- TYPE, 


’’trueT , 


1L, 


MC I _ RETURN. TYPE _ STRING, 


’’FALSEf , 


〇 L, 


MCI- RETURN- TYPE _ STRING, 


"" 

r 


〇 L, 


MCI- END- RETURN- TYPE, 



□ 2-12 MCI. RETURN- TYPED 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□ 

□ □□□□ mciSendString □□□□□，□ pszReturnString □□□□□□□□□□ 

3 . MCI FLAG 

□ □□□□□□□□□□□□□□□□□□□ ulParaml[] □□□□□□□□□□ 

□ □□□□□□□□□□□ MCI — FLAG □□□，□□□ ulParaml □□□□□□□□□ 

□ □□□□□□□□□ 

4 . MCI STRING 

□ □□□□□□□□□□□□□□□□□ MCI. STRING □□□□□□□□□□□ 

□ □□□□□□□□□ mdm 

5 . MCI INTEGER 

□ □□□□□□□□□□□□□□□□ MCI — INTEGER □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ ULONGQ 

6 . MCI CONSTANT 

□ □□□□□ MCI— END— CONSTANT □□□□□，□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□ 2-13 □,□□□□□□□□□□□□□□□□□□ (time 
format constant ) □□口 



"" 

r 


MCI. SET. TIME— FORMAT, 


MCI - CONSTANT, 


’’time format milliseconds". 


MCI- FORMAT- MILLISECONDS, 


MCI- INTEGER, 


"time format ms 〃， 


MCI- FORAMT- MILLISECONDS, 


MCI- INTEGER, 


’’time format rnmtime ” ， 


MCI- FORAMT- MMITME, 


MCI- INTEGER, 


〃〃 

’ 


〇 L, 


MCI - END _ CONSTANT, 
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□ 2-13 MCI. CONSTANT □ 

MCI』 CONSTANT □□□□□□□□□ ulParaml □□□□□□□□□□□□□□ 

□ □ MCI — INTEGER □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□ ULONGD 

7 . MCI DEFAULT . STRING 

□ □□□□□ MCI - DEFAULT — INTEGER □□□,□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□ ,LOAD 〇 □(□ 2-14 □□)□□□□□□□□□□□□□ 

□ □□□□□□ 



"loacf. 


MCI_ LOAD, 0, 


MCI - COMMAND _ 


HEAD, 


^ notify , 


MCI_ NOTIFY, 


MCI - FLAG, 




wait , 


MCI_ WAIT, 


MCI - FLAG, 




〃 〃 
new r 


〇 L, 


MCI - FLAG, 




’’readonly' 


MCI- READONLY, 


MCI - FLAG, 




"" 

r 


MCI_ 〇 PEN_ ELEMENT, 


MCI - DEFAULT _ 


STRING, 


"〃 

r 


〇 L, 


MCI - END_ COM 


^[AND, 



□ 2-14 MCI- DEFAULT- STRING □ 



8 . MCI RECTL 

□ □□□□□□ RECTL □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ ULONG □ □ □ □ □ 

□ □ □ 

9 . MCI OR 



□ □□□□□□□□□□□□□□□□□□□□□□□□□□[I 2-15 □□□□□ 
MCI. OR □□□□，□□□□□□ MDMCMD .RC □ □ □ □ MCI. STATUS □ □ □ □ □ 
□ □，□□□□□□□□□ %d 〇 □□□□□□□□□□□□□□□ 



" 〃 

r 


〇 L, 


MCI_ OR, 


’’track" 


MCI. TRACK, 


MCI_ INTEGER, 


’’channel". 


〇 L, 


MCI_ CONSTANT, 


〃 all 〃， 


MCI- STATUS- AUDIO- ALL, 


MCI- INTEGER, 


"left". 


MCI- STATUS- AUDIO. LEFT, 


MCI_ INTEGER, 


’’right ’、 


MCI- STATUS- AUDIO. RIGHT, 


MCI_ INTEGER, 


" % cf , 


〇 L, 


MCI- INTEGER, 


〃" 

r 


〇 L, 


MCI_ END- CONSTANT, 


〃" 

r 


〇 L, 


MCI- END- OR, 



□ 2-15 MCI- OR □ 



10 . MCI STRING - LIST 
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□ □□□□□□□□□□□□□□□□□□□，□ 2-16 □□ MCI - STRING- LIST 

□ □□□□□□□□□□□□□□□ 



’’group". 


MCI. GROUP, 0, 


MCI. COMMAND. HEAD, 


"delete ” ， 


MCI- GROUP- DELETE, 


MCI _ FLAG, 


" n 〇 pi ecemeal ” ， 


MCI_ NOPIECEMEAL, 


MCI _ FLAG, 


"synchronize" , 


MCI- SYNCHRONIZE, 


MCI _ FLAG, 


wait r 


MCI. WAIT, 


MCI _ FLAG, 


^ notify , 


MCI. NOTIFY, 


MCI _ FLAG, 


"〃 

r 


〇 L, 


MCI_ INTEGER, 


"" 

r 


〇 L, 


MCI. INTEGER, 


master r 


MCI- GROUP- MASTER, 


MCI. STRING, 


〃" 

r 


〇 L, 


MCI_ STRING, 


"" 

r 


〇 L, 


MCI. INTEGER, 


〃 . 〃 
make r 


MCI- GROUP- MAKE, 


MCI - STRING- LIST, 


〃" 

r 


〇 L, 


MCI - END- COMMAND, 



□ 2-16 MCI. STRING- LIST □ 

252 □□□□□□□□□ 

□ □□□□□□□□□□□,□□□□ MDM □□□□□□□□□□□□□□□□ 
□ □ 2-17D □ □ □ □ MCI-SEEKD □ □ □ □ □ 



〃 , 〃 
seek , 


MCI. SEEK, 0 , 


MCI_ COMMAND. HEAD, 


^ notify r 


MCI_ NOTIFY, 


MCI - FLAG, 


wait r 


MCI_ WAIT, 


MCI. FLAG, 


"to start". 


MCI_ TO- START, 


MCI_ FLAG, 


”t 〇 encf. 


MCI_ T 〇 _ END, 


MCI_ FLAG, 


"t 〇〃 ， 


MCI. TO, 


MCI_ INTEGER, 


〃 " 

r 


〇 L, 


MCI - END— COMMAND, 



□ 2-17 □ □ □ □ 

□ □□□□□□□□ mciSendString □ pszCommand □□□" seek〃[] ,□ SEEK □ □ 

□ □□□□□□□□□□□□□□□□，□□ mciSendString □ pParam2 □□□□□□ □ 

□ □ 

□ ULONG：] seek " □□口 

□ □ ULONG □□□□□□: MCI _ SEEK □0□□□□□(□□□，□□ MCI - SEEK) □ 

□ □ USHORT □，□□□□□□□□□ USHORT □ □ □ □ □ ULONGQ MCI. COM- 
MAND- HEADQ □ □ □ □ MDM,D Q Q ULONG(Q □□□□□□ USHORT)Q □ Q □ 
mciDriver Entry [] usMessage □ □ □ 

□ □□□□□□□□ MCI. FLAG,D □□□□□□□ ULONG □□□□□□□□ 

MCI _ FLAG □□□□□□□ ULONG ulParaml □□ □ 
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□ ulParaml □□ □ 

□ □□□□□□ ULONG □□□□□□□□□□□□□□ ULONG, □□□ hwnd- 
CallbackQ □□□□□□□□□□□□□□ ULONGQ □□□□□□□□□□□□□□ 

□ □□□□□□□□□ 

□ □□□□□□□□ MCI — INTEGER, □□□□□□□ S []〇 

□ □□□□□ null[] □□□□□)，□□ pszCommand[] □，□□□□□□□□□□□□ 
pParam2 □□□□□□□□□ ULONG □□□□□□□□□□□ 

□ □□□□□□□□ MCI. STRING, □ □□□□□□ SDDDDD，DD pszCom- 
mand □□,□□□□□□□□□□□□□□□□□□□□ pParam2 □□□□□□□□□ 
ULONG □□□□□□□□□□□ 

□ □,□□□□□□ MCI— RETURN, □□□□□ ULONG □□□□□□□□□□ 

□ □□ pParam2 □□□□□□□□□□□ 

pParam2 □□□□□□□□□□□□□□□□□□□□□□□ ULONG □□ □ 
hwndCallback[] □□□□□□□□□□ ULONG □□□ MCI _ RETURN : 

■ □ MCI. RETURN □□□，□□□□ □ ULONG □ MCI — INTEGER, □ □ pPa- 
ram2 □□□□ ULONG □□ ulReturnQ 

■ □ MCI- RETURN □□□,□□□□ □ ULONG □ MCI — STRING, □□ pParam2 

□ □□□ ULONG □□ ulReturn,[] □□ ULONG □□ ulRetSizef] ulRetSize[] □ 

□ □□□□□□□ 

pParam2 □□□□□□□□□□□□□□□□ ULONG □□□□ MCI — INTEGER 

□ MCI — STRING □ □ □ □ □ □ □ ， MCI — CONTANT □ MCI — END . CONTANT □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ ULONGQ □ □ □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□ 

□ 2-18 □ □ □ MCI. STATUS □ □ □ □ □ 



"status \ 0", 


MCI _ STATUS, 0, 


MCI ■ COMMAND _ HK 


AD, 


" \ (T, 


MCI- INTEGER, 


MCI - RETURN, 




"notify \ (T, 


MCI_ NOTIFY, 


MCI . FLAG, 




’’wait \ 0", 


MCI_ WAIT, 


MCI . FLAG, 




" \ (f , 


MCI- STATUS- ITEM, 


MCI _ CONSTANT, 




"mode \ (T, 


MCI. STATUS. MODE, 


MCI_ INTEGER, 




"ready \ (T, 


MCI. STATUS. READY, 


MCI_ INTEGER, 




’’current track \ (T, 


MCI- STATUS- CURRENT- TRACK, 


MCI - INTEGER, 




’’length \ 0 〃， 


MCI. STATUS. LENGTH, 


MCI_ INTEGER, 




’’number 〇 f tracks \ (T, 


MCI. STATUS. NUMBER. OF. TRACKS, 


MCI_ INTEGER, 




"position \ (T, 


MCI. STATUS- POSITION, 


MCI_ INTEGER, 
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"position in track \ CT, 


MCI- STATUS- POSITION- IN _ TRACK, 


MCI_ INTEGER, 


"time format \ 0 〃， 


MCI- STATUS- TIME- FORMAT, 


MCI_ INTEGER, 


"speed fonrat \ 0 〃， 


MCI_ STATUS- SPEED. FORMAT, 


MCI_ INTEGER, 


" \ (T, 


〇 L, 


MCI - END. CONSTANT, 


"track \ 0 〃 


MCI_ TRACK, 


MCI_ INTEGER, 


" \ (T, 


〇 L, 


MCI_ END. COMMAND, 



□ □□□□□ 


□ □□□□□ 


□ 2-18 MCI_ STATUS □□□ □ 
pParam2 □□□□□□□ : 


{ 

mm 


h wndCal lba ck ; 




ULONG 


ulReturn; 




ULONG 


ulltem; 




ULONG 

} 


ulTrack; 





□ □ :MCI - CONSTANT □□□ □ status □□ □ ulltem □ □ □ □ □ MCI - CON- 
STANT □ □□□□□□□□□" \ 〇 "□ NULL, □□□□□□□□□□□□□□□□□ 

□ ULONG □□□□□□□□ ulltem □□□□□ MCI - CON- 
STANT □□□□□□□□□" \ 

□ □ ULONG □ ulParaml □□□□□□□,□□□□□□□□□□□□□□□□□□□ 

□ □□□□： 



"capability ”， 


MCI - GETDEVCAPS, 


〇 , 


MCI- COMMAND. HEAD, 


"" 

r 


MCI - PRER 〇 LL_ TYPE. RETURN, 


〇 , 


MCI_ RETURN- TYPE, 


"deterministic ” ， 


MCI - PREROLL _ DETERMINISTIC, 




MCI - RETURN- TYPE. STRING, 


"notified’ 


MCI - PREROLL _ NOTIFIED, 




MCI_ RETURN- TYPE. STRING, 


" " 
none r 


MCI - PREROLL- NONE, 




MCI - RETURN- TYPE- STRING, 


" 〃 
none r 


〇 L, 




MCI - END- RETURN- TYPE, 


"〃 

r 


MCI - TRUE- FALSE - RETURN, 


〇 , 


MCI - RETURN- TYPE, 


’’trueT , 


1L 




MCI - RETURN- TYPE. STRING, 


’’FALSE% 


〇 L, 




MCI_ RETURN- TYPE. STRING, 


"〃 

r 


〇 L, 




MCI - END- RETURN- TYPE, 


〃" 

r 


MCI - DEVICENAME - RETURN, 


0, 


MCI - RETURN- TYPE, 


"videotape" , 


MCI - DEVTYPE- VIDEOTAPE, 


0, 


MCI - RETURN- TYPE. STRING, 


’’videodisc ’、 


MCI ■ DEVTYPE _ VIDEODISC, 


0, 


MCI - RETURN- TYPE. STRING, 


"CD audio ”， 


MCI - DEVTYPE_ CD _ AUDIO, 


0, 


MCI - RETURN- TYPE. STRING, 
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"DA 寸， 


MCI - DEVTYPE _ DAT, 


〇 , 


MCI - RETURN- TYPE. STRING, 


’’Audiotape" , 


MCI_ DEVTYPE. AUDIO- TAPE, 


〇 , 


MCI - RETURN- TYPE. STRING, 


"Other ”， 


MCI ■ DEVTYPE _ OTHER, 


〇 , 


MCI_ RETURN. TYPE. STRING, 


"Waveaudio" , 


MCI - DEVTYPE— WAVEFORM- AUDIO, 


0, 


MCI - RETURN. TYPE. STRING, 


’’Sequencer ” ， 


MCI - DEVTYPE - SEQUENCER, 


0, 


MCI - RETURN- TYPE- STRING, 


"Ampmix ”， 


MCI - DEVTYPE— AUDIO- AMPMIX, 


0, 


MCI_ RETURN- TYPE STRING, 


’’Overlay", 


MCI ■ DEVTYPE _ OVERLAY, 


0, 


MCI_ RETURN- TYPE. STRING, 


’’Digitalvideo" , 


MCI - DEVTYPE_ DIGITAL- VIDEO, 


0, 


MCI - RETURN- TYPE. STRING, 


"Speaker% 


MCI _ DEVTYPE _ SPEAKER, 


0, 


MCI_ RETURN- TYPE. STRING, 


’’Headphone ” ， 


MCI - DEVTYPE- HEADPHONE, 


0, 


MCI - RETURN- TYPE. STRING, 


"Microphone ” ， 


MCI_ DEVTYPE. MICROPHONE, 


0, 


MCI - RETURN- TYPE. STRING, 


’’Monitor", 


MCI - DEVTYPE - MONITOR, 


0, 


MCI - RETURN- TYPE- STRING, 


〃 CDX ^’ ， 


MCI _ DEVTYPE _ CDXA, 


0, 


MCI - RETURN- TYPE. STRING, 


〃〃 

r 


〇 L, 




MCI - END- RETURN- TYPE, 


"" 

r 


MCI- INTEGER, 




MCI_ RETURN, 


^ notify r 


MCI _ NOTIFY, 




MCI_ FLAG, 


wait , 


MCI _ WAIT, 




MCI_ FLAG, 


〃" 

r 


MCI - GETDEVCAPS - ITEM, 




MCI- CONSTANT, 


’’can record ’ ， 


MCI - GETDEVCAPS- CAN- RECORD, 




MCI- INTEGER, 


’’can insert" , 


MCI-GETDEVCAPS-CAN_REC 〇 RD_ 


INSERT, 


MCI_ INTEGER, 


’’has audio ”， 


MCI - GETDEVCAPS- HAS- AUDIO, 




MCI_ INTEGER, 


’’has video ” ， 


MCI - GETDEVCAPS- HAS- VIDEO, 




MCI- INTEGER, 


"can eject" , 


MCI ■ GETDEVCAPS - CAN_ EJECT, 




MCI- INTEGER, 


"can play ” ， 


MCI ■ GETDEVCAPS _ CAN_ PLAY, 




MCI- INTEGER, 


’’can save" , 


MCI_ GETDEVCAPS- CAN_ SAVE, 




MCI_ INTEGER, 


"uses files ”， 


MCI_ GETDEVCAPS- USES - FILES, 




MCI- INTEGER, 


〃 c 〇 rrp 〇 und device". 


MCI - GETDEVCAPS- USES - FILES, 




MCI- INTEGER, 


"can locke ject ”， 


MCI - GETDEVCAPS- CAN- LOCKE JECT, 


MCI- INTEGER, 


’’can set volume ”， 


MCI - GETDEVCAPS. CAN_ SETVOLUME, 


MCI_ INTEGER, 


"preroll type" , 


MCI_ GETDEVCAPS_ PREROLL- TYPE 


r 


MCI_ INTEGER, 


’’preroll time ” ， 


MCI_ GETDEVCAPS- PRER 〇 LL_ TIME 


r 


MCI_ INTEGER, 


’’device type ” ， 


MCI - GETDEVCAPS- DEVICE- TYPE, 




MCI- INTEGER, 


'"can stream r 


MCI ■ GETDEVCAPS - CAN_ STREAM, 




MCI- INTEGER, 


〃 ca n pr 〇 ce s s int e rnal" , 


MCI ■ GETDEVCAPS - CAN_ PROCESS _ 


INTERNAL, 


MCI_ INTEGER, 


"" 

r 


〇 L, 




MCI - END- CONSTANT, 


"message ” ， 


MCI - GETDEVCAPS - MESSAGE, 




MCI_ CONSTANT, 


’’acquire". 


MCI - ACQUI REDEVICE, 


〇 , 


MCI- INTEGER, 


"release". 


MCI ■ RELEASEDEVICE, 


0, 


MCI_ INTEGER, 


〃 〃 
open r 


MCI ■ OPEN, 


0, 


MCI- INTEGER, 


" .. 〃 
close , 


MCI ■ CLOSE, 


0, 


MCI- INTEGER, 


’’escape ”， 


MCI - ESCAPE, 


0, 


MCI- INTEGER, 


" 〃 
play , 


MCI ■ PLAY, 


0, 


MCI- INTEGER, 
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〃 n 〃 
seek r 


MCI - SEEK, 


〇 , 


MCI_ INTEGER, 


stop , 


MCI - STOP, 


〇 , 


MCI- INTEGER, 


〃 〃 
pause r 


MCI _ PAUSE, 


〇 , 


MCI_ INTEGER, 


info r 


MCI_ INFO, 


0, 


MCI_ INTEGER, 


"capability” ， 


MCI_ GETDEVCAPS, 


0, 


MCI- INTEGER, 


"status". 


MCI - STATUS, 


0, 


MCI- INTEGER, 


" . 〃 
spin r 


MCI - SPIN, 


0, 


MCI- INTEGER, 


"set 〃 ， 


MCI - SET, 


0, 


MCI- INTEGER, 


"'step r 


MCI - STEP, 


0, 


MCI_ INTEGER, 


"recorcf. 


MCI ■ RECORD, 


0, 


MCI- INTEGER, 


〃 . f - rr 

sysinfo , 


MCI - SYSINFO, 


0, 


MCI- INTEGER, 


" 〃 
save r 


MCI — SAVE, 


0, 


MCI_ INTEGER, 


" " 
cue , 


MCI ■ CUE, 


0 


MCI- INTEGER, 


"update ”， 


MCI - UPDATE, 


0, 


MCI- INTEGER, 


"setcuep 〇 int 〃 ， 


MCI - SET- CUEPOINT, 


0, 


MCI- INTEGER, 


〃 setp 〇 siti 〇 nadvise 〃 ， 


MCI - SET _ POSITION- ADVISE, 


0, 


MCI- INTEGER, 


〃 setsync 〇 f fset 〃 ， 


MCI - SET _ SYNC- OFFSET, 


0, 


MCI- INTEGER, 


"loacf , 


MCI_ LOAD, 


0 


MCI- INTEGER, 


’’masteraudio" , 


MCI _ MASTERAUDIO, 


0 


MCI- INTEGER, 


"gettoc ”， 


MCI - GETTOC, 


0, 


MCI- INTEGER, 


^ connect or r f 


MCI ■ CONNECTOR, 


0, 


MCI_ INTEGER, 


’’resume". 


MCI ■ RESUME, 


0, 


MCI_ INTEGER, 


"〃 

r 


〇 L, 




MCI - END _ CONSTANT, 


r 


〇 L, 




MCI - END- COMMAND, 



■ i 

pParam2 □□□□□□□□: 


{ 

ULONG 


hwndCal lb ack ; 


ULONG 


ulReturn; 


ULONG 


ulltem; 


ULONG 


ulMessage ; 


} 





□ □ : message"。 □□□□□□□□□□□□□□□□□□□□ 

message open'D □□□□□□□□□ MCI- GETDEVCAPS. MESSAGE □ ulParaml □ 

□ ,□ □ □ MCrOPEND □ ulMessageD □ □ 

□ □□□□□□□□□□□□□□□□□□□ INTEGER □ STRING □□□□ □ 

□ □ MCI— DEFAULT — INTEGER □ MCI — DEFAULT □□□□□□□□□□□□□ 
□，□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□ 
□ ： 
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\ 0〃， MCI_ FILENAME, MCI _ DEFAULT _ STRING, 



□ □□□□□□□□□ ULONG, □ MCI — STRING □□□□□ □ 

□ □□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□，□ 

□ □ □ DLL)D □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ □ 

2 5 3 □ □ □ 

□ □□□□□□□□□□□□ ,MCDQ □□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□ RCDATA □□□□□□□□□□□□□□，□□□□□ 

□ □□□□□□□□□ MMPM2 .INI □□□□□□ MCDT ABLE □ VSD TABLE □ □ 

DLL □□□□□□□□□□□□□□□□□ +MMERROR— TABLE- BASE：] □ 

□ □□□□□ RCDATA □□ 506, □□□□□□□ : 

■ 500 ，□□□□ MCIDRV .H □□□□ MMERROR TABLE BASE 〇 

■ 6, □□□□□□□□□□□□ (□□，□□ MCIOS2 .H □ □ □ □ MCI- DEV- 
TYPE. OTHERQ) 

□ □□□□□，□□□□□□□□□□□□□□# define □□□□，□□□ RCDATA 

□ □ □ □ ： 

# define MMERR. TABLE. MY. DEVICE MMERROR. TABLE. BASE + MCI — DEVTY PE _ OTHER 



□ □□□□□□□□□□□□□□ mciGetErrorString, MDM □□□□□□□□□ 

□□□□□□□□□□□□□,□□ mdm □□□□□□□□□□□□□□□□□□□ 

□ □□□□□ ULONG □□□□□，□□□□□□□□□□□□，□□□□□□□ 

□ ： 



RCDATA 506 

BEGIN 



MCIERR- INVALID. DEVICE- NAME, " Invalid Device Name given" 

MCIERR. SUCCESS , "MyPM Command corrpleted successfully" 



MCIERR- INVALID. DEVICE. ID, 
MCIERR. UNRECOGNIZED. KEYWORD, 
MCIERR. UNRECOGNIZED. COMMAND, 
MCIERR. HARDWARE, 



Invalid device ID given 
Unrecogni zed keyword 
Unrecogni zed command’ 
Hardware error" 



■ 33 ■ 






MCIERR. OUT. OF. MEMORY, "System out 〇 f memory" 



MCIERR. MSG. TABLE. END 
END 



□ □：□□□□□□□□□□□□□□, MCD □ n □ MCIERR- UNSUPPORTED- 
FUNCTIONO □□□□□□□□□，□□□□□□□□□□□， MCD □□□□ □ 
MCIERR UNSUPPORTED. FLAGQ 

2.6 □ □ □ □ 

■ □ □ 

■ □ □ 

■ □ □ 

■ □ □ 

■ □□□□□□□□ 

■ □□□□□□□□ 

■ □□□□□□□□ 

■ □□□□□□□□ 

■ □ □ 

□□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ □ 2-19 □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□，□□□□□□□□□□□□□□□□，□□□□□□□□□□□，□ MCD 

□ □□□□□□ 

□ □：□□□□□□ (SEEK)D □□，□□□□□□□□□□□□□□□□□,□□ 

□ □□□□□□□□□□□□□□□□ MCD □□□□□□□□ 2-19 □□□□□□□□ 

□ □ □ □ 
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□ 2-19 □ □ □ □ □ 



27 MCD 



□ □□□□□I □□□□□□ mciSendCommand □□，□□□□□□□□ (MDM )〇 

□ □□□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□,□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□ mdm □□□□□□□□□□□□□ 

□ □ □ □ □ mciDriverEntry[] □□□□□□ AUDIOMCD DLL □□□□□□□□□ 

□ □ AUDIOMCD □□□□□□□□□□□□ AUDIOIF,[] □ □ □ □ □ MCD,[] □ 2-20 

□ □□□□□□□□□ MCD □□□□ MMIO □ SSM □□□□ □ 



□ 2-20 □ □ □ □ MCD □ □ 
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271 □□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□，□□□□ MCD □□□ MCI _ SET □ 

□ □□□□□□□□□□□□□□□□ mcd □□□□□□□□□□□□□□□,□□ 

□ □□□□□ MCD □□□□□□ MCD □□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□ □□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□ 

□ 2-21 □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 



ulplnstance - > usWaveDevicelD = pDrvQpenParams - > usDevlcelD; 

ulDeviceTypeID = MAKEUL 〇 NG(MCI_ DEVTYPE. WAVEFORM. AUDIO, 

pDrvQpenParams - > usDeviceOrd) ; 

* Ensure that the INI file contains the right device id 



usDeviceT ype 



MCI_ DEVTYPE- WAVEFORM. AUDIO) 



if (pDrvQpenParams 

{ 

return (MCIERR_ 皿 - FILE) ; 

} 

usConnLength = sizeof (DEFAULTC 〇 NNECTT 〇 NS2 ) ; 

ulrc = mciQueryDefaultConnections (ulDeviceTypelD, 

& DefCon, 
&usC 〇 nnLength) ; 

* Ensure that the INI file says that we are connected 

* t 〇 an arrp mixer • If it says that we are connected 

* to ourselves, return an error . 









if (ULONG- LOAD (DefCon .dwDeviceTypeID2) 

{ 

return (MCIERR. INI _ FILE) ; 

} 



: MCI - DEVTYPE— WAVEFORM- AUDIO) 



2-21 Connect ToAmp □□□ (LOADS UBS .C) 



□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 
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2.7 2 MMIOD □ 



□ □ □ □ MCD □ □ MMIO □□□□□□□□□： 

1 . □□□□□□□□; 

2. □□□□□□□□□□□□□□□□□□□□□□； 

3- □□□□□□□□； 

4 .□□□□□□ ; 

5 .□□□□□□ □ 

2721 □□□□□□□ 

□ MCD □□□□□□□□□□□□□□□□□□□ 

□ □□□□ mmioGetHeader,[] □□□□□□□□□□□□□□(□□□□□□□□□□ 

□ □□□□□□，□□□□□□□□□□□□□□□□□，□□)□ AUDIOMCD □□ □ 

□ □□，□□□□□□□□□□□□□□，□□□□□□□□□ AUDIOIF0 AUDIOIF □ 

□ IOCtlQ □,□□□□□□□□□□□□□ 




* A streaming MCD should utilize MMIO to perform all 

* file manipulations • If we use MV [工 〇, then the MCD 

* will be free from file dependencies, that is, if a RIFF 

* IOProc or a VOC I〇Pr〇c is loaded will be irrelevant • 

ulrc = nmioGetHeader (ulplnstance - 〉 hmmi〇， 

(PVOID) &ulplnstance - > mmAudioHeader, 
size〇f(ulplnstance _ > mmAudioHeader ) , 
(PLONG) &BytesRead, 

(ULONG) NULL, 

(ULONG) NULL); 

if (ulrc = = MMIO. SUCCESS) 

{ 

* Copy the data from the call into the instance 

* so that we can set the artp^ mixer up with the 

* values that the file specifies . 




AMPMIX .sMode = WAVEHDR jjsFormatTag; 

AMPMIX .sChannels = WAVEHDR jjsChannels; 

AMPMIX .ISRate = WAVEHDR ulSarrplesPerSec; 

AMPMIX .IBitsPerSRate = WAVEHDR ^isBitsPerSairple; 

ulplnstance - > ulDataSize = XWAVHDR .ulAudioLengthlnBytes; 

AMPMIX .ulBlockAlignment = (ULONG) WAVEHDR .usBlockAlign; 
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ulplnstance - > ulAverageBytesPerSec = WAVEHDR nsChannels * 
WAVEHDR ulSarrplesPerSec * (WAVEHDR nsB it sPer Sample 8) ; 

}/ * SuccesFul GetHeader */ 

else 

{ 

ulrc = mmioGetLastError (ulplnstance - 〉 hmmi〇） ； 

} 

return (ulrc) ; 

}/ * GetAudioHeader * / 



□ 2-22 GetAudioHeader □□□ (AUDIOSUB .C) 

□ □□ mmioGetHeader □□□ hmmio □ mmioOpen 

□ mmioGetHeader □□□ MMIO □□□□, MMIO □□□□□□□ mmAudioHeader □ 

□ □□□□□□□□□□ MMAUDIODATA □ □ □ □ mmioGetHeader □□□ □ 
MMAUDIODATA □□□,□□□□□□□□□□□□□ MCD □□□□□□□□□□ 

□ □□□□□□□□□□□： 

!•□□□□□□□□□□□ ( us Format Tag ) ; 

2. □□□□□□□□□□□□□ (usChannels) ; 

3- □□□□□□□□□□□□□□□□□□ (usSamplesPerSecD usBitsPerSample) ; 
4. □□□□□□□ (ulAudioLengthlnBytes)D 
2722 □□□□□□□□ 

□ 2-23 □□□□□□ □ MCD □ □ □ □ □ MMCTOCENTRY □ □ □ □ □ ulMed- 
TypeQ □ □ □ MMIO- MEDIATYPE. AUDIO □ □□□□ 

□ □□□□ !/〇□□，□□□□□□□□□□□□□□□： 

1 . MMIO MEDIATYPE- IMAGE; 

2 . MMIO MEDIAT YPE _ AUDIO; 

3 . MMIO MEDIATYPE. MIDI; 

4 . MMIO MEDIATYPE. COMPOUND; 

5 . MMIO MEDIATYPE. OTHER; 

6 . MMIO MEDIATYPE. UNKNOWN; 

7 .MMIO MEDIATYPE. DIGITALVIDEO; 

8 .MMIO MEDIATYPE- ANIMATION; 

9 . MMIO MEDIATYPE. MOVIE 〇 

□ 〇 s / 2 〇〇〇〇〇〇〇〇〇 



mmioinfo .aullnfol； 3] = MV [工 〇_ MEDIATYPE- AUDIO/ 
/ * Open the file */ 






p Instance - > 



' iinmioCpen(pFileName f 

&mmi 〇 inf 〇， 



ulFlags) ; 

* Check for errors— see comments from above */ 



if (p Instance - >hmmio = = (ULONG)NULL) 



iftmmioinfoiilErrorRet^^iyiyilQERR-MEDIA-lSDT-FCOND) 



return (MCIERR- INVALID. MEDIA- TYPE) ; 



return(rtimioinfo jjlErrorRet) ; 



p Instance - > ul Capabilities = 0; 



* Since the wave IOProc opened the file, we know 

* that it has the following capabilities . 

plnstance - > ulCapabilities = (CAN. INSERT I CAN. DELETE I CAN. UNDOREDO + 

CAN . SAVE I CAN . INSERT I CAN . RECORD) ; 






* Get The Header Information 






if ( ! (ulFlags & MMIO. CREATE) ) 



u lrc = GetAudi 〇 Header( plnstance) ; 



}/ * Not Create Flag : 



plnstance - > ulDataSize = 0; 



plnstance - > fFileExists = TRUE; 

* You cannot do the set header immediately after file creation 

* because future sets on sarrples, bitpersairple, channels may follow 



return (ulrc) ; 

}/ * CpenFile */ 



□ 2-23 OpenFileD □ □ (AUDIOSUB .C) 
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2723 □□□□ 

□ □ p o □ □ □ MMPM2 .ini □□□□□□□□ 

□，□□□□□□□□□□□□□□□□□□□□□□□□□ 2- 24 □□□□□□□□ 
INIQ □□□□□□□□ (Quality of Service, □ □ □ QOS )〇 □ □ 

□ □□□□□□□□ MCD, □ □ MMIOM — BEGINS TREAM □ MMIOM— ENI> 
STREAM：] □□□□□□□□□ (LAN) □□□□□□□□□ 2-24 □□□□，□□□ 
MMIOM. BEGINSTREAM □□□□□ 

* 

: The MMPM2 .INI file contains two variables that 
: a streaming MCD should retrieve .The first one 
: QOS- VALUE (Quality of Service) contains settings 
: which describe the quality of service that the 
: network the user is streaming from will try to 
: support (for exairple, GUARANTEED or DONTCARE) • 

: If this quality of service is not available A then another 
: variable (QOSERRORFIAG) describes whether 〇 r not 
: to notify the caller . 



ulrc = mciQuerySysValue (MSV- SYSQOSVALUE, &ulplnstance - > lQosValue) ; 

if ( ! ulrc) 

{ 

ulplnstance - > lQosValue= DONTRESERVE; 

} 

ulrc = mciQuerySysValue (MSV. SYSQOSERRORFIAG, &ulplnstance - > lQOSReporting) ; 

if ( ! ulrc) 

{ 

ulplnstance - > lQOSReporting = ERROR. DEFAULT; 

} 

□ 2-24 Quality of Service □ □ □ (LOADSUBS .C) 

□ 2-25 □ □ □ EndQuality of Service □□□□□，□□ 〇 ^2 〇〇〇〇〇〇〇〇〇〇 
□ □□□ !" 〇 □□□□□□□□□□ MMIOM — BEGINSTREAM □ MMIOM— ENI> 

stream □ □□□□□□ ^ 〇 DD,DDDD mcdd □□□□□□□□□□□ 

ULQNG EndQualityofService (INSTANCE * plnstance) 
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LONG rc; 

rc = mmioSendMessage (p Instance - 〉 hmmi 〇 , 

END STREAM, 

〇, 

〇); 

return (rc) ; 

}/ * EndQual it yof Service */ 



□ 2-25 EndQuality of Service □□□ (STRMSUBS .C) 

2 724 □ □ MMIOQ □ □ □ 

□ □ □ □ □ MCD □ □ □ □ MMIO □□□□□□□□□□□□□□ (MCI)D □ □ □ 
□ □□ 2-12 □□□□□ MMIO □□□□□□□□□□□□□□□□□□□□ 



□ 2-12 MMIOD □ □ 



MMIOD □ 


MCI □ □ □ □ □ □ 


MMIOM DELETE 


MCI. CUT 


MMIOM READ 


MCI. READ 


MMIOM DELETE 


MCI. DELETE 


MMIOM UNDO 


MCI. UNDO 


MMIOM REDO 


MCI- REDO 


MMIOM DELETE, MMIOM BEGININSERT 
□ MMIOM ENDINSERT 


MCI. PASTE 


□ 2-26 □□□□□□□ MMIO □□□□□□□ (paste) □ □□□□□□ 


* Remove the information in the file if 

* fron/ to are specified . 


* * * * * 






if (ulParaml&MCI — FRCMl lulParaml&MCI. TO) 

{ 

IReturnCode = rnmioSendMessage (plnstance - > hmmio, 

MMICM- DELETE, 
pEditParms - > ulFrom, 
ulPasteLen) ; 

if (IReturnCode ! = MMIO- SUCCESS) 

{ 

ulrc = mmioGetLastError (plnstance - > hrnmio) ; 
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PasteNotify ( &FuncBlock f ulParaml f ulrc) ; 
return (ulrc) ; 



if ( !(ulParaml&MCI- T 〇 - BUFFER)) 

{ 

* Let the IOProc know that the information is 

* about to be inserted into the file 

IReturnCode = imioSendMessage (plnstance - > hrtimio, 

BEGININSERT, 

〇); 

if (IReturnCode ! = 應工〇 _ SUCCESS) 

{ 

ulrc = mmioGetLast Error (plnstance - > hmmio) ; 
PasteNotify ( &FuncBlock, ulParaml^ulrc) ; 
return (ulrc) ; 




* We have finished inserting the information 

* the paste is corrplete 

IReturnCode = irmioSendMessage (plnstance - > hmmio, 

MMIOM. END INSERT, 

〇); 
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if ( IReturn Code != MV [ 工 〇 _ SUCCESS) 



ulrc = mmioGetLastError (plnstance - > hmmio) ; 
PasteNotify ( &FuncBl 〇 ck,ulParaml,ulrc) ; 
return (ulrc) ; 



□ 2-26 StartPasteD □ □ (ADMCPST .C) 



2 7 3 □□/□□□ 

□ □ □ □ MCD □□ SPI □□□□□/□□□□ (SSM)D □，□□□□□□□□□, 

□ □□□□□□□□(□□□)□□□□□□(□□)□ 

2731 □□□□□□□□□ 

□ □□□□ MCD □□□□□□□□□□□□□,□□□ SpiGetHandler □ 

□ □□□□□□□□□□□□□□□ ssm,d □□□□□□□□□□□□□□□□□□ 

□ □ SSM 




* Get^ A" stream Handler Handles for Source & target operations 

* The file system stream handler is the default ' A" handler 

* but the memory stream handler will be used for playlists . 

if (ulrc= SpiGetHandler ( (PSZ) DEFAULT- SOURCE- HANDLER- NAME, 

&hidASource, 

&hidATarget) ) 

{ 

return (ulrc) ; 

} 

* Get ' B’ stream Handler Handles for Source & target operations 

* The audio stream handler is considered the B stream handler 

* since it will usually be the target . 

ulrc= SpiGetHandler ( (PSZ) DEFAULT. TARGET. HANDLER. NAME, 

&hidBS 〇 urce, 

&hidBTarget) ; 

return (ulrc) ; 



□ 2-27 StreamSetup □ □ □ (LOADSUBS .C) 
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□ □□□□ MCD □□□□□□□□ ID □□,□□□□□ SPCBKEY □□□□， □ 

□ □ SSM □□□□□□□□□□, SPCBKEY □□□ 

□ □□□□□□，□□□□□□ SSM" □□□□ PCM □□ ,8 □ ,22kHz 〃〇 

□ □,□□□□ MCD □□□□□□□□□ (DCB ),〇 □□ SSM □□□□□□□□□ 
(□ □ 2-28 □□)□ DCBD □□□□□□□ : 

1 . ASCII □□□□□□□□□□； 

2 •□□□□□ □ 

ASCII □□□□□□□□□□□□ INI □□□□□□，□□□ MDM □□□□□□ 
AUDIOIF □□□□□, IOCtl □□□□□□□□□，□□□□□□□□□ 

Syslnfo 111 Item = MCI- SYS INFO. QUERY. NAMES; 

Syslnfo jjsDeviceType = LOUSHORT (ulDeviceType) ; 

Syslnfo pSys Inf oParm = &QueryNameParm; 

it oa (HIUSHORT( ulDeviceType) ^szlndex, 10) ; 

szlndex[ 1] \ (X ; 

strncat ( szAmpMix, s zlndex, 2 ) ; 
strcpy(Query]N[amePam .szLogicalName, szArrpMix) ; 

if ( rc = mciSendCommand (0 , 

MCI- SYSINFO, 

MCI - SYSINFO- ITEMlMCI- WAIT, 

(PVOID) & Syslnfo, 

〇)) 

return ( rc) ; 



Get PDD associated with our ArtpMixer 
Device name is in pSysInfoParm - > szPDDName 




Syslnfo ^illtem =MCI. SYSINFO. QUERY. DRIVER; 

Syslnfo jjsDeviceType = (USHORT) ulDeviceType; 

Syslnfo pSysInfoPam= &Sys Inf oParm; 

strcpy(Sys Inf oParm .szInstallName^QueryNameParm ^zlnstallName) ; 

if ( rc = mciSendCommand ( 0, 

MCI - SYSINFO, 

MCI - SYSINFO- ITEM I MCI - WAIT, 

(PVOID) & Syslnfo, 

〇)) 

return ( rc) ; 
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strcpy( szPDD Name f Sys Inf oParm ^zPDDName) ; 



return (MCIERR- SUCCESS) ; 
}/ * GetPDDName */ 



□ 2-28 GetPDDName □ □ □ (AUDIOSUB .C) 



2 7 32 □□□□□ 

□ □□□□□□□□ ID □□□□□□ SPCBKEY □ DCB □ □ □ □ , MCD □ □ Spi- 
CreateStream 

□ □□□,□□□□□□□□□□□□□ 

□ 2-29 □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ ,□□□□□□□□□□□□□□(□ MCIOPEN . 〇 □□□□□□□□□□□□,□□ 

□ □□□□□□□ 



ulrc= SpiCreateStream(hidSrc, 

hidTgt, 

&plnstance - 〉 Streamlnfo SpcbKey, 

(PDCB) &plnstance - > Streamlnfo AudioDCB, 
(PDCB) &plnstance - > Streamlnfo AudioDCB, 
(PIMPL- EVCB) &plnstance - > Streamlnfo Evcb r 
( PEVFN) Event Proc, 

(ULONG) NULL, 
hStream, 

&plnstance - > Streamlnfo JnEvent) ; 



□ 2-29 CreateNAssocStream □□□ (AUDIOSUB .C) 

□ MCD □□□□□□□□□□，□□□□ SSM □□□□□□□□□□□□□□□ 

□ MCD □□□□□□□□□□□□，□□□□□□□□□□□□□□ SSM □ □ □ □ □ 

□ □□□□□□□□□□□□□□□□□□□，□ SSM □□□□，□□□□□□□□□ 

□ □ 

□ □□□□□ MCD □□□□□□□□□□ (routine) : 

■ RecordEventRoutine( ADMCRECD .C) , □ □ 2-30; 

■ PlayEventRoutine(ADMCPLAY .C), □ □ 2-31 口 

RC APIENTRY RecordEventRoutine (MEVCB * pevcb) 

{ 

MTIME- EVCB * pMTimeEVCB; // Modified EVCB 

INSTANCE * ulplnstance; // Instance Ptr 
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* EventProc receives asynchronous SSM event notifications 

* When the event is received, the event semaphore is posted 

* which will wake up the MCD thread(s) blocked on this 

* semaphore • 

* The semaphore is not posted for time events like 

* cuep 〇 int( TIME) and media position changes since they do 

* not alter the state of the stream . 



switch(pevcb - > evcb ulType) 



case EVENT _ IMPLICIT _ TYPE: 



* Retrieve our instance from the EVCB */ 



ulplnstance = (INSTANCE * ) pevcb - > ulpln stance; 



switch (pevcb - > evcb ulSubType) 



case EVENT. ERROR: 

ulplnstance - > StreamE vent = EVENT . ERROR; 



* Check for playlist specific error first 



* End 〇 f PlayList event is received 

* as an irrplicit error event .It 

* is treated as a normal EOS 

if (ulplnstance - > usPlayLstStrm = = TRUE) 

if (pevcb - > evcb ulStatus = = ERROR. END. OF. PLAYLIST) 
ulplnstance - > Streamlnfo Evcb .evcb ulStatus = 
lyiMIOERR. CANNOTWRITE; 

DosPostEventSem( ulplnstance - > hEventSem) ; 
break; 



case EVENT- STREAM. STOPPED: 



* Event Stream Stopped Release the 

* Blocked thread 
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ulplnstance - > StreannEvent = EVENT. STREAM. STOPPED; 
DosPostEventSem(ulpInstance - > hEventSem) ; 



break; 

case EVENT- SYNC- PREROLLED: 

* This event is received in response to a 

* preroll start A Preroll start is done 

* on an MCI ■ CUE message • 




ulplnstance - > StreamEvent = EVENT. SYNC. PREROLLED; 
DosPostEventSem( ulplnstance - > hEventSem) ; 
break; 



□ 2-30 RecordEventRoutine G D D (ADMCRECD .C) 

Record Event Routine □□ MEVCB □□□□□□□□□□ IMPL- EVCB，SSM □ □ 

□ □□□□□(□□_ 2[] □□□□□□□)□□□□□□□□□□□□□□ EVCBQ 

□ □□□，□ 2-31 □□ MEVCB □□□□□□□□□，□□□□□□□□□□□□□ 
SSM □□□□□□ MCD □□□，□□□ MCD □□□□□□□□□ 

□ 2-31 □□□ PlayEventRoutine □□□□□□□□ SSM □□□□□□□□□□,□ 

□ □□□□□□□□□□ (cue point) (□□□□□□□□□□)□□□□□□□□□□□ 

□ ,□□□ mdmDriver Notify □ MDM □□□□ MCI』 CUEPOINT □□口 



RC APIENTRY PlayEventRoutine (MEVCB * pevcb) 

{ 

MTIME- EVCB * pMTimeEVCB; / 氺 Modified Time EVCB 氺 / 

INSTANCE * ulplnstance; / * Current Instance */ 

HWND hWnd; / * Callback Handle */ 

BCXDL fP layListDone = FALSE; 

* EventProc receives asynchronous SSM event notifications 

* When the event is received, the event semaphore is posted 

* which will wake up the MCD thread(s) blocked on this 

* semaphore • 

* The semaphore is not posted for time events like 

* cuep 〇 int( TIME) and media position changes since they do 

* not alter the state of the stream . 



■ 47 ■ 






switch (pevcb - > evcb ulType) 



case EVENT- IMPLICIT- TYPE: 

/ * Retrieve our instance from the EVCB */ 
ulplnstance = (INSTANCE * ) pevcb - > ulpln stance; 

/ * Retrieve the callback handle to post messages on */ 
hWnd= ulp Instance - > hwndCallBack; 
switch (pevcb - > evcb ulSubType) 

{ 

case EVENT. EOS: 

ulplnstance - > StreannEvent = EVENT. EOS; 

DosPostEventSem(ulpInstance - > hEventSem) ; 
break; 

case EVENT- STREAM— STOPPED: 

/ * Self explanatory— someone stopped the stream*/ 

ulplnstance - > StreamEvent = EVENT. STREAM. STOPPED; 
DosPostEventSem( ulplnstance - > hEventSem) ; 
break; 

case EVENT- SYNC. PREROLLED: 

* This event is received in response t 〇 a 

* preroll start A Preroll start is done 

* on an MCI . CUE message . 

ulplnstance _ > StreairEvent = EVENT. SYNC. PREROLLED; 
DosPostEventSem( ulplnstance - > hEventSem) ; 
break; 

case EVENT- PLAYLISTMESSAGE: 

* We can receive this event if a playlist 

* parser hits the MESSAGE COMMAND . 

* NOTE: The MCD should return this message 

* with the callback handle specified on the 




* open .This could be the source of much 

* grief if you return on the wrong handle . 



mdmDriverNotify(ulpInstance - 〉 usWaveDevicelD, 

ulplnstance - 〉 hwndQpenCallBack, 
m. MCIPIAYLISTMESSAGE, 

(USHORT) MAKEULONG(pevcb - > evcb ulStatus, 
ulplnstance - > usWaveDevicelD ) , 

(ULONG) pevcb - > evcb .unusedl) ; 

break; 

case EVENT. PLAYLISTCUEPOINT: 

* We can receive this event if a playlist 

* parser hits the CUEPOINT COMMAND opcode 

* in the playlist • This differs from a "normal” 

* cuepoint because it is detected by the source, 

* rather than the target stream handler . 

mdmDriverNotify ( ulplnstance - 〉 usWaveDevicelD, 

ulplnstance _ > hwndCpenCallBack, 

剛 - MCICUEPOINT, 

(USHORT) MAKE ULONG (pevcb - > evcb .ulStatus, 
ulplnstance - > usWaveDevicelD) f 
(ULONG) pevcb - > evcb .unusedl) ; 

break; 

}/ * SubType case of Irrplicit Events */ 
break; 

case EVENT- CUE _ TIME- PAUSE: 

{ 

* This event will arrive if we played to a certain 

* position in the stream Let the play thread know 

* that we have reached the desired point • 

pMTimeEVCB=(MTIME_EVCB*)pevcb; 

ulplnstance =( INSTANCE * ) pMTimeEVCB - > ulplnstance; 
ulplnstance - > St re anEvent = EVENT- CUE- TIME - PAUSE; 

DosPostEventSem( ulplnstance - > hEventSem) ; 
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break; 

case EVENT- CUE- TIME : 
break; 

}/ * All Events case */ 
return (MCIERR. SUCCESS) ; 

} / 氺 Pl^yEventProc 氺 / 

Q 2-31 PlayEvent Routine Q Q Q (ADMCPLAY .C) 

□ □□□□,□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ ,SSM 

□ □□□□□□□□□□□□□□□，□□□□□□□□□□□□，□□□□□□□ 

□ □ □ □ □ 

2733 □□□□ 

□ □□□□□□□，□□□□□ SpiEnableEvent □□□□□□□□□□□□□□□ 

□ □ □ 2-32Q □ □ EVENT- CUE. TIME _ PAUSED □，□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□ mcdq □ □ 

□ □□□□□□，□□□□□□ 

RC CreateToEvent (INSTANCE * ulpln stance, ULONG ulTo) 

{ 

/ * rename this function CreateToEvent */ 

ULONG ulrc; 

* Set up a cue time pause event at the place in 

* the stream where the caller wants us to play record 

* to . Note: this event will pause the stream and 

* will be considerably more accurate than just 

* setting a cue point , receiving the event and stopping 

* the stream (since a normal cue point will force 

* bleed over) . 

ulplnstance - > Streamlnfo JTimeEvcb iiwndCallback 
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= ulplnstance - > hwndCallBack; 






ulplnstance - 〉 Streamlnfo JTimeEvcb .usDevicelD 

= ulp Instance - > usWaveDevicelD; 
ulplnstance - > Streamlnfo JTimeEvcb .evcb ulType 



□ 2-33 StarPlay □ □ □ (ADMCPLAY .C) 



SpiDisableE vent (ulplnstance - > Streamlnfo .hPlayToEvent) ; 



□ □□□□□□□□□□□□□□/□□□□□□ SpiDisableE vent □□□□□□□□ 



[_| 2-32 DoTillEvent □□□ (AUDIOSUB .C) 



if (Operation = = PLAY. STREAM) 

{ 

ulrc = Spi Associate ( (HSTREAM) * hStream, 

hidSrc, 

(PVOID) &plnstance - 〉 Streamlnfo acbmmio) ; 
}/ * Associating play stream */ 



= EVENT _ CUE _ T IME _ PAUSE; 
ulplnstance - > Streamlnfo .TimeEvcb .evcb nl Flags 
= EVENT. SINGLE ； 

ulplnstance - > Streamlnfo JTimeEvcb .evcb list ream 
= ulplnstance - > Streamlnfo JiStream; 
ulplnstance - > Streamlnfo .TimeEvcb .ulplnstance 
= ( ULQNG) ulplnstan ce ; 

ulplnstance - > Streamlnfo .TimeEvcb .evcb rrmtimeStream = ulTo; 



/ * Enable the cue time pause event . */ 

ulrc= SpiEnableEvent ( (PEVCB) &ulplnstance - > Streamlnfo .TimeEvcb avcb, 

(PHEVENT) & ulplnstance - > Streamlnfo hPlayToEvent) 

return (ulrc) ; 



}/ * CreateToEvent 




□ 2-34 CreateNAssocStream □□□ (AUDIOSUB .C) 
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2735 □□ MCI ■ LOAD □□□□□□□□□ 

□ □□□□□□□□□□□□□□□□，□□□□□□ 16 □ llkBQ WAVE □ , □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□(□□□□)□□□□□□□□，□□□□□□□□□ —— □□□□□□□(□ 

□ □□ (discard stop) 〇 [j □□□ (flush stop)[] □□□□□□ (EOS )) 口 




* Reassociate The Stream Handlers with the new 

* stream object if the stream has been created 

* in the correct direction already . 

if (ulplnstance - > ulCreateFlag = = PREROLL- STATE) 

{ 

* Fill in Associate Control Block Info for 



file system stream handler (FSSH) FSSH will 
use the mmio handle we are associating to 
stream information • 




ulplnstance - > Streamlnfo .acbmmio .ulObjType = ACBTYPE. MMIO; 
ulplnstance - > Streamlnfo .acbmmio .ulACBLen = sizeof (ACB. My[IO) ; 
ulplnstance - > Streamlnfo .acbmmio Jnrtimio = ulp Instance - > hmmio; 




* Associate FileSystem as source if Playing JNIote 

* the association is always done with the file 

* system stream handler since it is involved with 

* irmio operations If you try this with the 

* audio stream handler, you will get invalid 

* handle back . 




if (AMPMIX .ulOpe ration = = OPERATION- PLAY) 

{ 

ulrc= SpiAssociate ( ulplnstance - > Streamlnfo .hSt ream, 

ulplnstance - > Streamlnfo .hidASource, 

(PVOID) & ulplnstance - > Streamlnfo acbmmio) ; 




* Associate FileSystem as target if recording 
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else 



ulrc= SpiAssociate ( ulpln stance - > Streamlnfo .hStream, 

ulpln stance - > Streamlnfo .hidATarget, 

(PVOID) &ulplnstance - > Streamlnfo acbmmio) ; 

}/ * else we are in record mode */ 



□ 2-35 MCILOAD .C □ □ □ (ADMCLOAD .C) 

2736 □□□□□□□□ (prerolling) —— □□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□ SpiStartStream Q Q [ 
START- PREROLL □□□□□ □ 

□ □，□□□□□□□□□□□ (STOP- PAUSED), □ □□□□□□□ 
(cue),[] □□□□□□ SpiStartStream □□□□□□□□□ 2-36 □□□□□ □ 

□ □□□□□□□ 



* If the stream is paused, there is no 

* sense in cueing it since the buffers 

* are full anyway 

if ( STRMSTATE = = MCI _ PAUSE I I 
STRMSTATE = = STOP . PAUSED) 












If the stream is going the right way 
then we have the ability to avoid the cue 
since the buffers have been filled up before 
we did the pause 






*/ 



if ( AMPMIX ulOperation = = OPERATION- RECORD & & 
f Cue Input) 

{ 

ulplnstance - > ulCreateFlag= PREROLL . STATE; 
STRMSTATE = CUERECD. STATE; 
return (MCIERR. SUCCESS); 



* If the current stream is cued for playback and 

* we have a cue. output request, our work is done 



□ □ □ □ 
] □ spi — 

□ □ □ □ 
□ □ □ □ 
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else if (AMPMIX .ulOperati on = = OPERATION. PLAY&& 
fCueOutput) 



ulp Instance - > ulCreateFlag = PREROLL . STATE; 
STRMSTATE= CUEPLAY. STATE; 
return (MCIERR_ SUCCESS); 



I f the stream may be in cue state * / 



□ 2-36 MCICUE .CD □ □ (ADMCCUE .C) 

2 J A □ □ □ □ MCD □ □ □ □ □ 

□ 2-37 □□□□□□□□□□□□□□ (AUDIOMCT .DLL)[] □□□□ □ 
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□ 2-37 □ □ □ □ MCD □ □ 





2 7 4 1 □ □ □ □ MCD DLL(AUDIOMCT .DLL) 

□ 2-13 □□□ AUDIOMCT .DLL □□□□□□□□□□ 



□ 2-13 □ □ □ □ MCD 〇 □ □ □ □ 



□ □ □ □ 

ADMCOPEN .C □□ MCI— OPEN □□□□□□ MCI- OPEN MCD □□□□ □ 



LOADSUBS .C 



□ □ ： 

1 •□□□□□□□□□□; 

2.D INI □□□□□□□□ (□□□□□□); 

3 MCI. OPEN— PLAYLIST(D □□□□□) ; 

4 MCI- OPEN— MMIO (〇 □□□□□) ; 

5 □ MCI. OPEN_ ELEMENT(D □□□□□)； 

6. □□□□□□□□； 

7- □□□□□□□□ (□□□□□□)□ 

□ □ MCI- OPEN □ MCI - LOAD □ 



1 •□□□□□□□ (CheckForValidElement) ; 

2 •□□□□□ □ (Load AbortNotify) ; 

3 ，□ □ OPEN_ MMIOD □ (OpenHandle) ; 

( 〇 penHandle)(ProcessElement); 

5 •□□□□□ □ ( Process Element ) ; 

6 MMIOQ □ □ □ □ □ ( ProcessElement) ; 

7 □ MCI— READ— ONLYQ □ (ProcessElement); 

8 •□□□□□ □ (SetupTempFiles) ; 

9 G mmioSendMessage API Q 1/ 〇 □ □ □ □ (SetupTempFiles) ; 

10 •□□□□□□□□□□□□□□; 

!!•□□□□□□ (StreamSetup) ; 

12 . □ □ MCI. NOTIFY □ MCI. WAIT □ □ □ □ □ ( Notify Wait Setup ) □ 



AUDIOMCD .C □□ MCIDRV— RESTORE □□□□□□□ MCD □□□□□□□□□□□ 



□ □□□□，□□□□□□□□ (restore)。 □(□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□ )□□□□□□□□□, 

MCDQ 

□ □ MCIDRV— SAVE □□□□□□□ MCD □□□□□□□□□□□□□ 



ADMCLOAD .C 



□ ,□□□□□□□□ (save)D □(□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□)□□□□□□□□□ ,MCDQ □ □ □ 

□ MCDD 

□ □ MCI. LOAD □□□□□□□□□□□□□ ： 

1 □ MCI. LOADD □□□□□□； 

2- □□□□□□□□□□； 

3 MCI - LOAD □□□□□□□□□ (cuepoint )/□□□□ (positionad- 

vise) ; 



■ 55 ■ 








□ □ 



ADMCCAP .C 



ADMCSTAT .C 



ADMCCUE .C 



ADMCSEEK .C 



□ □ 




4 ，□ □ MCI. LOADD □ □ □ □ OPEN_ MMIO; 
5 •□□□□□□ MCI . LOAD 



□ □ □ □ 

□ □ MCI- GETDEVCAPS □□□□□□□□□□□□□ MCI- GETDEV- 
CAPS □□□□□： 

!•□□□□□□□□□□□ MCD □ □ □ □ play, close □□□□□ ,□□□□ 

□ □ sysinfoD □□□□(□□□□□□□□□-□□ ")□ 

2- □□□□□□□□ ( capability ) 〇 〇〇 ,□□□□□□□□□□□□□(□ 

□ □□□□□)□ mcdd 

□ □ MCI. STATUS □ □□□□□□□□□□□□ MCI. STATUS □ □ □ □ 

!•□□□□□□□□□□□□□□□□□□□； 

2 - □□□□□□□□□□□□□； 

3 . □□□□□□□□□□□□□□； 

4- 

5. □□□□□□□□□； 

6 . □□□□□□□□□□ 

□ □ MCI. CUE □□□□□□□□□□□ MCL CUE □□□□□□□□□ 

□ □□□□□□□□□□□ MCD, MCI— CUE □ □ □ □ □ SPI. START. 
PREROLLQ □□□ (preroll) □ 

□ □□□ ,MCI_ PLAY □ MCI - RECORDQ □ SpiStartStream 口 

□ □□□□□□ 

□ □ MCL CUE MCD □□□□□□□□: 

1 •□□□□□□□□□□; 

2. □□□□□□□□□□□□□ (cue)Q 

3- □□□□□□□□□□□□ (cue) ,□□□□□□ ： 

⑴ □□□□□□□□; 

(2) □□□□□□□□□□(□,□□□□□ )□□□□； 

(3) □□□□□(□□□□□□ ); 

(4) □ □ □ (preroH)D □ □ □ 

4- □□□□□□□□□□□□, □□□□□□： 

⑴ □□□□□□□□; 

(2) □□□□□□□□□□,□□□□； 

(3) □□□□□(□□□□□□ ); 

(4) □□□□□□ □ 

□ □ MCI- SET- CUEPOINT □□□□□□□□□，□□□ MCDQ □□□ □ 

□ □ ： 

1 •□□□□□□□□□□; 

2 •□ □ □ □ (cuepoint)D □□□□(□□□□□□□□□□□)□ 

□ □ MCL SEEK □□□□□□□□□,□□□ MCD □□□□□□□ : 
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□ □ 



□ □ 


□ □ 




1 




□ 


□ 


□ 


□ 


□ □ 


□ □ □ □ ； 
















2 


0 


□ 


□ 1 


□ 1 


□ 


MCI 


. FROMQ MCI. TOD □ ; 
















3 




□ 


□ 


□ 


□ 


□ □ 


□ □□□□□□； 
















4 




□ 


□ 


□ 


□ 


□ □ 


□ □□□□□□□□； 
















5 




□ 


□ 


□ 


□ 


□ □ 


















6 
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□ 


□ 


□ 


□ □ 
















ADMCPLAY .C 


□ 


□ 


MCI- PLAY [ 


!□□□□□□□□□,□□□ mcdd □ D 


□ 


□ 


□ 


□ 








1 
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□ □ 
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(□□□□□□□□□)□□□□(□□□□□□)□ 
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□ □ 


(□□□□□□□□□□)□ 
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! 〇 ■□□□□□ MCI. NOTIFY, □ □□□□□□□□□□□ 














ADMCRECD .C 


□ 


□ 


MCI. RECORD □□□□□□□□□,□□□ MCDD □ [ 


] [ 


] [ 


] [ 


] □ : 






1 




□ 


□ 


□ 


□ 


□ □ 
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□ □ 
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□ ,□□□□□□□□□□□□□□□□□ 


□ 


□ 


□ 


□ 


□ 


□ 






□ 


□ 


□ 


□ 


□ 


□ □ 


















5 




□ 


□ 


□ 


□ 


□ □ 


□□□□□□□□□□□□□□□□□,□ 
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□ □ 
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□ □ 
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，□□□□□□ 
















1C 


)，□□□□□ MCI - NOTIFY, □ □□□□□□□□□□□ 














ADMCCLOS .C 


□ 


□ 


MCI 


. CLOSE □□□□□□□□□ ,□□□ MCD □□□□□□□： 








1 




□ 


□ 


□ 


□ 


□ □ 


□□□□□□□; 
















2 


•D 
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□ 


□ □ 


n n n ； 
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□ □ 

ADMCCONN .C 
ADMCREST .C 



ADMSAVE .C 
AUDIOSUB .C 



□ □ 




3- □□□□□□□□□； 

4- □□□□□□□□； 

5- □□□□□□□□□ (□□□□□□□)； 

6 •□□□□□ MCI— NOTIFY, □ □□□□□□□□□□ 

□ □ MCI- CONNECTOR □□□□□□□□□□□□□_□□□□□□ 

□ ,□□□□□□□□□□□ MCDDDDDD 

□ □ MCI- STOP □□□□□□□□□,□□□ MCD 〇 □□□□□□ : 

!•□□□□□□□□□□□； 

2 . □□□□□□□□□□□□□□； 

3. 

4- □□□□□□□□□□□ STOP. PAUSE □□□□□□□□□ 

□ □ MCI- RESUME □□□□□□□□□,□□□ MCD □□□□□□□ : 

1 •□□□□□□□ ; 

2- 

□ □ MCI. SETPOSITIONADVISE □□□□□□□ MCD 〇 □,□□□□ □ 

□ (positionadvise)D □□□□ xODDDDDDDDD (cuepoint)D □ □ □ □ 

1 •□□□□□□□□□□; 

2 - □□□□□□□□□□□□□,□□： 

⑴ 

(2) 

□ □ MCI- PAUSE □□□□□□□□□,□□□ MCD □□□□□□□ : 

1 •□□□□□□□ ; 

2 - □□□□□□□□； 

3. □□□□□□□□□□□□□ 

□ □ MCI- SAVE □□□ MCI- SAVE □□□□□□□□，□□□□□□ MCD 

□ □□□□□□□□□□□□： 

1 •□□□□□□ ; 

2 - □□□□□□□□□□□□□□□； 

3. □□□□□□□□□□； 

4 (save)[] □ □ 

□ □□□□□□□： 

1 •□□□□□□ ; 

2 ，□ □ □ MCI. WAIT □ MCI. NOTIFY □ □ □ □ □ (PostMDM Message) ; 

3 mmioGetHeader □□□□□□□□□□ (GetHeader) ; 

4. DDDDDDDDD ( playlist )□ □ □ (Associate Playlist) ; 

5 . □ □ ]/ O □ □ (InstalllOProc) ; 

6 •□□□□□□□ !/〇□□□□; 

7.DDDDDDDDDDDDD (OpenFile) ; 

8 •□□□□□□ (ConvertToMM + ConvertTimeFormat); 

9 D D D SPI □ (CreateNAssociateStream) ; 
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l 〇 • D D D D SPI □ (CreateNAssociateStream) ; 

11 play tc/ record to □□□□□□□ (DoTill Event)] 

ADMCPST .C □□ MCI— PASTE □□□□□□□□ MMIO □□□□□□□□ : 

1 .〇 □ MCI. FROM BUFFER □ MCI. TO. BUFFER □ 〇 ; 

2. □□□□□□□□□, □□□□□□□□； 

3 ，□ MMIOD □□□□□□□□ 

ADMCCOPY .C □ □ MCI. COPY, MCI. DELETE, MCI. CUT, MCI. UNDO □ MCI. REDO 

1 •□□□□ cul/ copy/ delete □□□□ ; 

2 □ MMIOM- DELETED □□□□□□； 

3 cut/ copy/ delete □□□□ ; 

4 MMIOM- UNDO □ MMIOM. REDOD □ □ 

ADMCEDIT .C □□□□□□□□□□□□(□ cutQ copy) ,□□□□□□ ： 

!•□□□□□□□□□□ MCI. FROM MCI. TO(CheckEditFlags) ; 

2 •□□□□□ from/ to ; 

3 . □□□□□□□□□； 

4- □□□□□□□□； 

5. □□□□□□□□; 

6 . 〇 MMIO □□□□□□□□□□□□ 

ADMCINI .C 

STRMSUBS .C □□ play, record □ cue □□□□□□ : 

!•□□□□ mmioQ □□□□□□ (QoseFile); 

2.DDDDDDDD/DDD (StopStream) ; 

3 - □□□□□□□□□□□□□□□□□□□□□□□□□□□； 

4 •□ □ □ □ MCI. SETQ □□□□□□ (Destroy Set St ream) ; 

5- □□□□□□□□□； 

MCI- TO □□□□□□□□□□ (cue time pause event) 
(ProcessFromToFlags) ; 

7.DDDDDDDDDDDD (EnableEvents) ; 

8 □ G D (BeginQualityofService,EndQualityofService)D 

28 □□□□□□□ ：〇〇 □□ MCD 

CD □□ MCD □□□□□□□□□ :CI> ROM □□□□□□ CD— ROM □□□□ □ 

□ SSMQ □□□□□□□ ^ (DAC)D 

□ □□□□□□□□□□□□□□□□□□□□□□, CD □□ MCD □ □ □ □ IOCtl □ 

□ □□□□□□□□□，□□□□□□□□□□□□ 

□ □ CD □ □ MCD □ □ □ □ □ 2-38 □ □ □ 
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□ 2-38 〇〇□□□□□□□□□□□□ 



281 □□□□□□ 

□ □ CI>ROM □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□ MCI- SET IOCtl[] □□□□□□□□(□□□□□□)□ 

2 J8 2 □ □ MCI _ PLAY □ □ 

CD □□ MCD □□ mciDriverEntry MCD □□□□□□ □ 

□ □□□□□□□□ (vendor- specific driver, Q Q Q VSD)Q 

□ □□□□ MCI— PLAY □□□□□□□，□□□ CD[][] MCD 〇 □□□□□□ □ 

□ vsdDriverEntry □□□□ process. msg，[] □□□□□□,□□ 2-39 □□ □ 



ULONG APIENTRY vsdDriverEntry (PVOID plnstance, US H 〇 RT usMessage, 

ULONG * pulParaml r PVOID pParam2 f 
USHORT usUserParm) 

{ 

ULONG rc, ulPITemp = MCI - WAIT; 

USHORT try = 1 ; 

if (pulParaml = = 〇 L) 

pulParaml = &ulPlTemp; 

/ * check t 〇 see if the drive is open, unless it is an Open message */ 
if (usMessage = = MCI _ OPEN) 

rc= CDAudCpen( * pulParaml, (MMDRV- OPEN. PARMS * )pParam2) ; 
else 
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/ * if the device is closed try reopening it unless you are closing*/ 
if ( ( (PINST) lplnstance) - > hDrive = = 0& &usMessage ! = MCI - CLOSE) 



rc = CD 〇 l . Cpen ( (PINST) lplnstance) ; 

/ * Clear commands not needing an open hardware device */ 
if ( rc = = MCIERR- DEVICE - NOT- READY) 

if ( (usMes sage = = MCI _ DEVICESETTINGS) I I 
(usMessage = = MCI _ GETDEVCAPS) I I 
(usMessage = = MCI - INFO) I I 
(usMessage = = MCIDRV_ REGISTER- DRIVE) I I 
(usMessage = = MCI _ SET. CUEPOINT) I I 
(usMessage = = MCI - SET- POSITION- ADVISE) I I 
(usMessage = = MCIDRV_ CD- STATUS- CVOL) I I 
(usMessage = = MCIDRV. SYNC & & 

! ( * pulParaml & MCIDRV- SYNC- REC- PULSE) ) ) 
rc = MCIERR_ SUCCESS; 

} / * of if drive needs to be open */ 
else / * drive was opened */ 
rc = MCI ERR _ SUCCESS; 

if ( !rc) 
do 
{ 

/ * process message */ 

rc = process - msg( (PINST) lplnstance, usMessage, 

pulParaml ,pParam2, usUserP am) ; 
if ( rc = = MCIERR. DEVICE . NOT . READY I I / * ERROR RECOVERY * / 

rc = = MCIERR. MEDIA. CHANGED) 

{ 

if ( ( (PINST) lplnstance) - 〉 Drive = = ' (T )/ * drive is closed*/ 

{ / * do not reissue commands * / 

rc = MCIERR- SUCCESS; 
break; 

} 

else 

if (try = = 2 ) 

break; / * quit after 2 tries .*/ 

else 

{ 

rc = CDAudErrRecov( (PINST) lplnstance) ; 

if (rc) / * error is still there, exit */ 

break; 
else 
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try + + ; 

} / * of else only tried the command once (try = = 1 ) */ 

} / * of if the drive was not ready */ 
else 

break; / * clear flag to exit */ 

} while (try) ; / * end of do loop and if no open error */ 

} / 氺 of else command was not MGI - 0PE1N [ 氺 / 

return (rc) ; 

} / * of vsdDriver Entry ( ) * / 

□ 2-39 vsdDriveEntry □ □ (IBMCDROM .C) 

process- msg □□□□□□□□□□□□□□□□□□□□ MCI — PLAY □□□□ □ 
(case)[] process-msg[] □ CD01- Play □ ，□□□□□□□□: 

■ Instance 

■ msg Par ami 

■ □ msgParam2 □ □ □ FROM □ □ 

■ □ msgParam2 □ □ □ TO □ □ 

■ MCI PLAY □ □ 

static ULQNG process— msg (PINST pInst,USH 〇 RT usMessage, 

ULONG * pulParaml, PVOID pParam2, USHORT usUserParm) 

{ 

ULONG rc; 

DosRequestMutexSem(pInst - 〉 hlnstSem, WAIT- FOREVER) ; 
if (usMessage ! =MCI_ PLAY) 

DOSReleaseMutexSem(pInst - > hlnstSem) ; //No protection needed 

/ * process message */ 
switch (usMessage) 

{ 

case MCI ■ CLOSE : 

rc = CDAudClose (plnst, * pulParaml ) ; 
break; 

case MCI - CUE : / * Pre-roll */ 

rc = CD 〇 1 . Cue(plnst) ; 
break; 

case MGI- GETDEVCAPS: / * Get Device Capabilities */ 

rc = CD 〇 1 _ GetCaps ( * pulParaml , (MCI _ GETDEVCAPS _ PARMS * ) pParam2) ,• 
break; 

case MCI - GETTOC: / * Get Table of Contents */ 
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if ( * pulParaml & WAIT. NOTIFY- MASK) 

rc = MCIERR_ INVALID _ FLAG; 
else 

rc = CD 〇 l - GetTOC (plnst, (MCI _ TOC- PARMS * ) pParam2) ; 
break; 

case MCI- INFO: 

rc=CDAudInf 〇 (pInst, *pulParaml, (MCI- INFO _ PARMS* )pParam2) ; 
break; 

/ * case MCI _ OPEN: open was already done in vsdDriverEntry( ) */ 

case MCI ■ PAUSE : 

rc= CD 〇 l_ Stop (plnst ， TIMER. PLAY _ SUSPEND) ; 
break; 

case MCI_ PLAY: 

rc = CD 〇 1 - Play (plnst, pulParaml , 

( (MCI _ PLAY- PARMS * ) pPararr2) - > ulFrom, 

( (MCI_ PLAY. PARMS * ) pPararr2) - 〉 ulT 〇 ,usUserPam, 

( (MCI- PLAY- PARMS * ) pParanG) - 〉 hwndCallback) ; 

break; 

case MCIDRV- REGISTER- DISC: / * Register Disc */ 

rc =CDAudRegDisc(pInst,REG_ BOTH, (MCI- CD_ REGDISC- PARMS* ) 
pParam2) ; 
break; 

case MCIDRV- REGISTER- DRIVE: / * Register Drive */ 

rc= CDAudRegDrive(pInst, (MCI. CD. REGDRIVE. PARMS * )pParam2) ; 
break; 

case MCIDRV- REGISTER- TRACKS: / * Register Tracks */ 

rc = CD 〇 1 . RegTracks (plnst, (MCI _ CD. REGTRACKS _ PARMS * ) pParanl2) ; 
break; 

case MCIDRV _ RESTORE: 

rc= CD 〇 l- Rest 〇 re(plnst, (MCIDRV- CD- SAVE- PARMS * )pParam2) ; 

break; / * Unpause * / 

case MCI - RESUME: 

rc = CD 〇 1 . Resume (plnst) ; 

break; 

case MCIDRV- SAVE: 

rc=CD 〇 l.Save(pInst ，（ MCIDRV_CD-SAVE_PARMS*)pParam2); 

break; 

case MCI - SEEK: 

rc = CD 〇 1 - Seek (plnst, ( (MCI - SEEK- PARMS * ) pPararr2 ) - > ulTo) ; 
break; 
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case MCI - SET: 

rc=CDAudSet(pInst,pulParaml, (MCI- SET- PARMS* )pParam2) ; 
break; 

case MCI - SET- CUEPOINT: 

rc = CD01 - CuePoint (plnst, * pulParaml , (MCI- CUEPOINT- PARMS * ) 
pParam2) ; 
break; 

case MCI - SET- POSITION- ADVISE: 

rc =CD 〇 l- P 〇 sAdvise(pInst, *pulParaml, (MCI - POSITION- PARMS* ) 
pParam2) ; 
break; 

case MCIDRV- CD- SET_ VERIFY: 

rc = CDAudSetVeri f y ( * pulParaml ) ; 
break; 

case MCI - STATUS: 

rc = CDAudStatus (plnst, * pulParaml , (MCI _ STATUS- PARMS * ) pParair2) ; 
break; 

case MCIDRV_ CD _ STATUS- CVOL: 

rc=CDAudStatCV 〇 l(&((MCI-STATUS-PARMS*)pParam2)->ulReturn); 

break; 

case MCI - STOP : 

rc= CD 〇 l- Stop (plnst ， TIMER- EXIT- ABORTED) ; 
break; 

case MCIDRV- SYNC: 

rc=CD 〇 l- Sync (pin st, * pulParaml, (MCI DRV- SYNC- PARMS* )pParam2) ; 
break; 

/ * List unsupported functions */ 

case MCI - ACQUI REDEVICE: case MCI - CONNECTION: case MCI - CONNECTOR: 

case MCI - CONNECTORINFO: case MCI _ DEVICESETTINGS : 

case MCI - DEFAULT- GONNECTIQNr case MGI _ ESGAPEr 

case MCI - LOAD: case MCI _ MASTERAUDIO: case MCI - RECORD: 

case MCI - RELEASEDEVICE: case MCI _ SAVE : case MCI - SPIN: 

case MCI - STEP : case MCI _ SYSINFO: case MCI - UPDATE: 

case MCIDRV- CD- READ- LONG: 

rc = MCI ERR- UNSUPPORTED - FUNCTION,, 
break; 

default : rc = MCIERR- UNRECOGNIZED- COMMAND; 

} / * of switch */ 
return ( rc) ; 

□ 2-40 Process- msg D D D (IBMCDROM .C) 

□ CD01 - Play □□ PLAY □□,□□□□□□ calllOCtl □□□□ □ 
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ULONG CD 〇 l - Play(PINST plnst, ULONG * pulParaml ,ULONG ulFrom, ULONG ulTo, 
USHORT usUserPam, HV\/ND hwndCallback) 

{ 

ULONG rc; 

ULONG ulThreadID; 

ULONG cnt; 



/ * Stop drive before issuing next play command */ 
if ( (plnst - 〉 usPlayFlag = = TIMER- PLAYING) I I 

(plnst - > usPlay Flag = = TIMER- PLAY- SUSPEND) I I 
(plnst - > usPlayFlag= = TIMER- PLAY_ SUSP- 2) ) 
if ( * pulParaml & MCI - NOTIFY) 

CD 〇 l - St 〇 p(plnst, TIMER- EXIT- SUPER); 
else 

CD 〇 l- Stop (plnst, TIMER _ EXIT- ABORTED) ; 

/ 氺 prepare for play call 氺 / 
plnst - > ulCurPos = ulFrom; 
plnst - > ulEndPos = ulTo; 

plnst - 〉 usPlayN 〇 tify= (USHORT) ( * pulParaml & (MCI- WAIT I MCI - NOTIFY) ) ; 
if ( * pulParaml & MCI - NOTIFY) 

{ 

plnst - > usPlayUserParm = usUserParm; 
plnst - > hwndPlayCallback = hwndCallback; 

* pulParaml = = MCI- NOTIFY; 

} / * notify flag was used */ 



if ( * pulParaml & MCI_ WAIT) 

rc = CD 〇 l . Timer (plnst) ; / * returns when play commands end * / 

else 

{ 

DosResetEventSem (plnst - 〉 hReturnSem, & cnt) ; / * force a wait 

rc = DosCreateThread (& ulThreadID, (PFNTHREAD) CD 〇 l _ Timer, 

(ULONG) plnst, 〇 L, THREAD- STACK- SZ) ; 

if (rc) 

{ 

rc = MCIERR- OUT- OF - MEiyDRY; 

DosPostEventSem (plnst - > hReturnSem) ; 

else / * wait for new thread to process enough */ 

{ 

/ * Let MCD know not to send notification by returning wait */ 
* pulParaml =( * pulParaml & MCI _ NOTIFY) I MCI - WAIT; 

/ * wait for new thread to process enough */ 
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DosWaitEventSem(pInst - 〉 hReturnSem, WAIT - FOREVER) ; 



DosReleaseMutexSem(pInst - > hlnstSem) ; 
} / * else no wait flag was used */ 

return (rc) ; 

}/ * of CD01. PlayO */ 

/ * 

/ * SUBROUTINE NAME: CD 〇 l . PlayCont 
/ * 

/ * 



DESCRIPTIVE NAME: CD Play Continue . 

氺 

* FUNCTION: Continue to play audio data to internal DAC (s) from a 
氺 MCIDRV- RESTORE or MCIDRV- SYNC command • 

氺 



氺 PARAMETERS: 

PINST plnst 
ULONG ulFrom 
ULONG ulTo 



■ Instance pointer . 
■From address . 

■T 〇 address in MMITME 



EXIT CODES : 



氺 

氺 

氺 

氺 



MCIERR. SUCCESS —action corrple ted without error . 
MCIERR. DEVICE. NOT. READY -- device was not ready, no disc • 
MCIERR- MEDIA- CHANGED -Disc changed . 



/ * NOTES ： 

/ * 

ULONG CD 〇 l . PlayCont (PINST plnst, ULONG ulFrom, ULONG ulTo) 

{ 

ULONG rc; 

BYTE param[PLAYAUD. PMAX] = {' d ,'T) O' / T ,RBMODE} ; 

ULONG ulDataLen = STAND RD - DMAX, ulParamLen = PLAYAUD - PMAX; 

/ * convert starting MM Time into Redbook 2 format * / 

* (ULONG* ) &param[STARTFFFLD] = REDB00K2FR0MMM(ulFrom) ; 

/ * convert ending MM Time into Redbook 2 format */ 

* (ULONG* ) &param[END. FF. FLD] = REDBOOK2FRCMMM(ulTo) ; 

/ * Stop drive before issuing next play command*/ 

CD 〇 l- Stop (plnst, TIMER. PLAY. SUSPEND) ; 

/ * play drive */ 



*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 
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rc=CallIOCtl (pInst,CDAUDia CAT, PLAY— AUDIO, 
param^ulParamLen, (feiilParamLen, 
NULL, ulDataLen, &ulDataLen) ; 

if ( ! rc) 

plnst - > ulCurPos = ulFrom; 

/ * if Timer was stopped, continue timer loop*/ 
if (plnst - > usPlayFlag= = TIMER. PLAY _ SUSPEND) 

plnst - >usPlayFlag=TIMER-PLAYING; 
DosPostEventSem (plnst - > hTimeLoopSem) ; 

return (rc) ; 

} / 氺 of CD01 _ PlayCont ( ) 氺 / 



□ 2-41 CD01- Play □ CD01_ PlayCont[] □ □ (IBMCDPRO .C) 

CalllOCtl □□□□ DosDevIOCtl hDrive □ □ 

□ □□□□□, ulCat □ IOCtl[] ulFunction □□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□[] 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 



ULONG CalllOCtl (PINST plnst, ULONG ulCat, ULONG ulFunction, 
PVOID pParam, ULONG ulPLen, ULONG * pulPLen, 
PVOID pData, ULONG ulDLen, ULONG * pulDLen) 

{ 

ULONG rc; 

DosRequestMutexSem (plnst - > hlOSem, (ULONG) - lL) ; 
rc = DosDevIOCtl (plnst - 〉 hDrive, ulCat, ulFunction, 
pParam, ulPLen, pulPLen, 
pData,ulDLen, pulDLen) ; 
DosReleaseMutexSem (plnst - > hlOSem) ; 

switch ( rc) 

{ 

case 〇 L: 

rc = MCIERR_ SUCCESS; 
break; 

case OxFF 〇 3 : 

rc = MCIERR_ UNSUPPORTED— FUNCTION; 
break; 

case OxFF 〇 6 : 
case OxFF 〇 8 : 

rc = MCIERR- OUTOFRANGE; 
break; 

case OxFF 〇 4 : 
case OxFFOC: 



DosOpen □ □ □ 

□□□□□□□ 
□ □，□□□□ 
□ □□□□□□ 
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rc = MCIERR- HARDWARE; 
break; 

case OxFFlO : 

rc = MCIERR_ MEDIA- CHANGED; 

break ; 
default : 

rc = MCI ERR _ DEVICE- NOT _ READY; 

} 

return ( rc) ; 

}/ * of CalllOCtlO */ 



□ 2-42 CallOCtl □ □ □ (IBMCDMSC .C) 

233 CD 〇 □ MCDQ □ □ □ □ 

□ 2-43 □□□ CD □□ MCD □□□□□□□ IBM 3510— 001 □ CI>ROM □□ □ 
□ VSD(IBMCDRT DLL)Q 
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□ 2-43 CD □□□□□□□□□□ 





2S31 CD □□□□□□□□□□ (CDAUDIOT DLL) 

□ □ CD □□ MCD(CDAUDIOT )〇 □□ MDM □□□□□□□□□□□□□□□ 

□ □，□□□□□ VSD □□□□□□□□ 

□ □□□□□□ CDAUDIOT .DLL □□□□□□□□ 

CDAUDIO £□□:□□□□□□ DLL □□□□□□□□□□□□□□□,□□□ 

□ 2-14 □□ 
CDAUDPRO ■ 〇 □□：□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□ MCD □□,□□□□□□□□□ VSD □□□□□□□□□□□□ VSD 

□ □□□□□□□□□□ 2-15 □□ 

□ 2-14 CDAUDIO.CG □ □ 




□ □ □ MDM □ MCD □ □ □ □ □ 

□ □□□□□□□□□□ 

□ □□□□□□□□□ 

□ □□□□□□□□□ 

□ □□□□□□□□□□ 

□ □ □ □ □ 

□ □□□□□□□ 

□ □□ VSD □ MCD VSD □□□□□□ 

□ □□□□□□□□□□ 



nnnnnnnnnnnn 



CDAUDPRO .C □ □ □ 



□ □ MCI. CLOSED □ □ 

□ □ MCI- CONNECTOR □□ □ 

□ □ MCI. CUE □ □ □ 

□ □ MCI- SET_ CUEPOINT □ □ 

□ □□□□ MCIDDD 

□ □ MCI- GETDEVCAPS □ □ □ 

□ □ MCI. INFO □ □ □ 

□ □ MCI. MASTERAUDIOD □ □ 

□ □ MCI- OPEN □ □ □ 

□ □ MCI. PAUSE □ □ □ 

□ □ MCI. PLAY □ □ □ 

□ □ MCI- SET- POSITION ADVISED □ □ 

□ □ MCIDRV_ RESTORE □□ □ 

□ □ MCI. RESUME □ □ □ 

□ □ MCIDRV— SAVE □ □ □ 

□ □ MCI. SEEK □ □ □ 



mciDriverEntry 


□ □ □ MDM □ MCD □ □ □ □ □ 


pre- process- msg 


□ □□□□□□□□□□ 


process, msg 


□ □□□□□□□□□ 


verify, entry 


□ □□□□□□□□□ 


QMAudio 


□ □□□□□□□□□□ 


Register 


□ □ □ □ □ 


ReRegister 


□ □□□□□□□ 


VSDReturn 


□ □□ VSD □ MCD VSD □□□□□□ 


SetTracklnst 


□ □□□□□□□□□□ 


Val Pointer 


□ □□□□□□□□□□□ 




MCI. SEEK □ □ □ 
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□ □ 



□ □ 


□ □ 


ProcSet 


□ □ MCI. SETD □ □ 


ProcSetSync 


□ □ MCI. SET. SYNC. OFFSET □ □ □ 


ProcStatus 


□ □ MCI- STATUS □ □ □ 


ProcStop 


□ □ MCI. STOPD □ □ 


ProcSync 


□ □ MCIDRV. SYNCD □ □ 



CDAUDUTL ■<：□□:□□□□□□□ CDAUDPRO .(：□□□□□□□□□□□□ 
□ □□，□□□□□□□□□□□□ 2-16 □□ 

□ 2-16 CDAUDUTL JC □ □ □ 



□ □ 


□ □ 


SetAudio 


□ MCI. SETD □ □ □ □ □ □ 


SetConnector 


□ □□□□□□□□□ 


SetCuePoint 


□ □□□□□ 


StatusMCD 


□ MCD □□□□□□□ 


StatusMCDDef 


□ MCD □□□□□□□□□ 


DisableE vents 


□ □□□□□□□□□□ 


GetTimeAddr 


□ □□□□□□□ MMTIME,Q □ □ □ 


Get T imeAddr RC 


□ □□□□□□□□□□□ 


GetTracklnfo 


□ □□□□□□□□□□ 


ValAddress 




ValS t ate 


□ □□□□□□□□□□ 


vsdResponse 


□ □ VSD □ □ □ □ 



CDMCINIT £□□:□□□□□□□□□□ DLL[] □□ 2-17 □ □ 



□ 2-17 CDMCINIT .C □ □ □ 


□ □ 


□ □ 


. DLL. InitTerm 


□ □ 〇 S^2DDDDDDDDD 


CDMCInitialization 


□□□□□□□ 


CDMC- Exit 


□□□□□□□□ 



CDMCCOMN £□□:□□□□□ CD MCD □ IBM CI>ROM □□□□ VSD □□ □ 
□ □□□□□ 2-18 □ □ 



□ 2-18 CDMCCOMN JC □ □ □ 



□ □ 


□ □ 


parse. DevParm 
get- token 


□□□□□□□□□ 

□ □□□□□□ (token) ,□ Q 


null □ □ □ □ 



HHPHEAP JCQ □：□□□□□□□□□□□□□□□□ 2-19 □□ 
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□ 2-39 HHPHEAP .C □□口 



□ □ 


□ □ 


HhpCreateHeap 


□ 


□ 


□ 


□ 


□ 


□ 


□ 










New Heap 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


(□ □ ： 


)□ 


HhpAllocMem 


□ 


□ 


□ 


□ 


□ 


□ 


□ 










Loca t e F reeM em 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 




HhpFreeMem 


□ 


□ 


□ 


□ 


□ 














Coll apseF re eB lock 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 




Coll apseF re eHe ap 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


HhpDestroyHeap 


□ 


□ 


□ 


□ 


□ 


□ 












HhpAllocBuffer 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


HhpFreeBuffer 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 




Hhp Acces sB uff er 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 




HhpAccessHeap 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 






H hp Rele aseHe ap 


□ 


□ 


□ 


□ 


□ 


□ 












AddPid 


□ 


PID 




□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ □ □ 


ReallocHeap 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


HhpGetPID 


□ 


□ 


□ 


□ 


PIDQ 










HhpDumpHeap 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


n n n 


2 J3 3 2 CD-ROM □ □ □ □ 


VSD(IBMCDRT DLL) 



□ □□□□ IBMCDRT DLL □□□□□□□□□□ 2-20 □□ 

■ CDMCINIT .C □ □ □ □ 2-17; 

■ CDMCCOMN.CDD □ □ 2-18; 

■ HHPHEAP .C □ □ □ □ 2-19; 

■ IBMCDPRO .C □ □ □□□□□ DLL □□□□□□□□□□□ CI>ROM □ □ 

□ □□□□□□□□□ 



□ 2-20 IBMCDROM JC □ □ □ 



n n 


n n 


vsdDriverEntry 


□ 


□ 


□ 


MCD 〇 


VSD □ □ □ □ □ 


process-msg 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


CDAudClose 


□ 


□ 


□ 


□ 


□ 


□ 


□ 








CDAudErrRecov 


□ 


□ 


□ 


□ 


□ 


□ 


□ 








CDAudlnfo 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 






CDAudOpen 


□ 


□ 


□ 


□ 


□ 


□ 


□ 








CDAudRegDisc 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ 


CDAudRegDrive 


□ 


□ 


□ 


□ 


□ 


□ 


MCD □□□□□□□□ 


CDAudset 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


CD AudSet Verify 


□ 


□ 


SET [ 


I [ 


1 [ 


I □ 


[ 


I □ 


CDAudStatus 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 






CDAudStatCVol 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


IBMCDPRO JCQ □ ：□ 


□ □ 


□ 


□ 


□ 


□ □□□□□ 2-21 □ □ 
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□ 2-21 IBMCDPRO .C □ □ □ 



□ □ 


□ □ 


CDOl-Cue 


□□□□□□□□□ 


CDO 1- CuePoint 


□ □□□□□□ ( cuepoint) □ 


CDO 1-GetCaps 


□ □□□□□□□ 


CDO 1-GetDiscInfo 


□ □□□□□□□□□ 


CDO 1- Get ID 


□ □□□□ CDIDQD 


CDO 1-GetPosition 


□ □□□□□□□□ 


CDO 1- Get State 


□ □□□□□□□ 


CDOl-GetTOC 


□ □ □ □ □ (MMTOCD □ )□ 


CDO 1- Get Volume 


□ □□□□□□□□□ 


CDO 1- LockDoor 


□ □□□□□□□□□□ 


CDO 1-Open 


□ □□□□□□□□□□□ 


CDO 1- Play 


□ □□□□□□□ 


CDOl-PlayCont 


□ □□□□□□ 


CDO 1-Pos Advise 


□ □□□□□□□□□□ 


CDO 1- RegT racks 


□ □□□□□□□ 


CDO 1- Restore 


□ □□□□□□□ 


CDO 1- Resume 


□ □□□□□□□□□□□□ 


CDO 1- Save 


□ □□□□□□□ 


CDO 1- Seek 


□ □□□□□□□□□□□□ 


CDO 1- Set Volume 


□ □□□□□□□□ 


CDO 1- Stop 


n n con n n n 



■ BMCDMSC 

□ □ □ IOCtlQ □ □ □ □ 2-22 □ □ 

□ 2-22 IBMCDMSC .CD □ □ 



□ □ 


□ □ 


CDO 1_ Star tPlay 


□ □ □ □ □ 


CDO 1- Sync 


□ MDM □ □ □ □ □ 


CDO 1- Timer 


□ □□□□□□□□□□ 


CDO 1- Timer notify 


□ □/□□□□□□□□□□□ 


GetTableName 


□ □ cdd □□□□□□□ 


OpenFirstTime 


□ □□□□□□□□ 


QueryTable 


□ □ CDQ □ □ (look-up table )〇 


CalllOCtl 


□ IOCtl □ □ □ □ □ 



29 □□□□□□□□ 

MDM □□□□□□□□□，□□□□□□□□□□□□：□□□□□□□□□□□ 



□ □ □ □ 
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□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□ MDM □ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □ □ 

□ □□□□□□ MCI- OPEN □□□，□□□□□□□□□□□□□□□□□□ 
MMDRV - OPEN PARMS □□□□□□□□□ MCIDRV- CHANGERESOURCE □ □ 

□ □ MDM, □ MDM □□□□□□□□□□□□□□□□□□□□□□□□，□□□□ 

□ □□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□ 

□ □□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

ProAudioSpectrum 16 "□□□□□□□□□□□□□□□□□□□□□□□□□□，□ 

□ midiq 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□ 

□ MIDI, 

□ □□□□□ 



210 □□□□□□□□□□□□□ 



□ □□□□□□□□□□□□，□□□□□□□□□□，□□□□□□□□□□□ 

(MDM)Q □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ ,□□□ MCI— DEVICESETTINGS □□□□□□ MCD □□□□□□□□□□□□□ 

5 5 3 3 .3 □" □□□□ INI □ 

□ □□□□□(□□□ mcd)Q 

□ □□□□□□□□□□□□□□□□□□□□□ 

□ □ ： 

1 . □□□□□□□□□□□□□□□□□□□□□□□□□□□□, □□□□□□ 

MMSYSTEM .C □ □ 

2. □□□□□□□□□□□□□□□□□□□ , □□□ 〇 $/ 2 PM □□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□，□□□□ MCI— SYSINFO — 
LOGDEVICE □ □ □ □ □ ulDeviceFlag □ □ □ □ MCI SYSINFO DEVICESETTINGS 

□ □□ (style bit )〇 □□□□□□□□ 2-44 □□□□□□□□□□□□□□□□□□□ 

□ □□□□□ MCI — SYSINFO — DEVICESETTINGS □□□□□ MCD □□□□□□ □ 

□ □□□□□□ 
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typedef struct - MCI- SYSINFO- LOGDEVICE{ 

CHAR szInstallName[MAX. DEVICE. NAME]; / 

USHORT usDeviceType; / 

ULONG u IDeviceFI ag ; / 

/ 

CHAR szVersionNiznber[MAX. VERSION. NUMBER] ;/ 
CHAR szProduct Info [MAX. PROD INFO] ; / 

CHAR szMCDDriver[MAX. DEVICE NAME] ; / 

CHAR szVSDDriver[MAX. DEVICE. NAME]; / 

CHAR szPDDName[MAX. PDD. NAME] ; / 

CHAR szMCDTable[MAX. DEVICE. NAME] ; / 

CHAR s zVSDTable [ MAX - DEVICE - NAME] ; / 

USHORT usShareType; / 

CHAR s zResourceName [MAX- DEVICE NAME] ; / 

USHORT usResource Units; / 

/ 

USHORT usResourceClasses; / 

/ 

USHORT ausClassAr ray [MAX_ CLASSES] ; / 

/ 

USHORT 

ausValidClassArray[MAX_ CLASSES] [MAX. CLASSES];/ 

} MCI - SYSINFO- LOGDEVICE; 



* Device install name 

* Device type number 

* Flag indicating whether device 

* device is controllable or not 

* INI file version number 

* Textual product description 

* MCI driver DLL name 

* VSD DLL name 

* Device PDD name 

* Device- type command table 

* Device- specific command table 

* Device sharing mode 

* Resource name 

* Total resource units available 

* for this device 

* Number of resource classes for 

* this device 

* Maximum number of resource 

* units for each class 

* Valid class combination */ 



□ 2-44 MCI— SYSINFO— LOGDE VICE □□□ □ 

□ □ MCD □□□□□□□□□□□□□□□□□，□□□□□□□□□□ MCD □ 

□ □ MCI — DEVICESETTINGS □□□□□□□□ MCD □□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□ (VSD) , □ MCD □ 

□ □□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□□□ 
□ □□□□□□ 

MCI— DEVICESETTINGS - PARMS □□□□(□ □ 2-45 □□)□□□□ □ MCI. 
DEVICESETTINGS □□□□ MCD[] □□□ hwndNotebook[] □□□□□□ CUA* □ □ 

□ □□□□□□□□□，□□□□□□□□□□ usDeviceType □□□□□□□□□□□ 

□ □ pszDeviceName □□□□□□□□□□□□□□ (WAVEAUDIOOl ),□□□□□ □ 

□ □□□□□ 



typedef struct - MCI_ DEVICESETTINGS - PARMS { 




ULONG 


hwndCal 1 back ; / 


* Window handle 


*/ 


mm 


hwndNotebook ; / 


* Handle to notebook window 


*/ 


USHORT 


usDeviceType; / 


* Device type 


*/ 


PSZ 

L } MCI- 


pszDeviceName ; / 

DRVTf!RqF_T TTKCS PARMS; 


* Device name 


*/ 
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□ 2-45 MCI- DEVICES ETTINGS- PARMS □□□ □ 





□□□□□□□□□□□□□□□□□□□□□□□□□□□□:□□□□□□□ 

□ □ □ □ □ WM _ HELP □□，□□□□□□(□)□□□□□□□□□□□□ HM_ DIS- 
PLAY . HELP □ □ □ 

□ □□□□ TabDDDD, □□□□□□□□□□□□□ MM- TABHELP □ □ (□ 

□ 2-46 □□)□□□□□□□□□□□□□□□□□□ 



MM- TABHELP 






rrpl 


ULONG ulPagelD / * Page identifier 


*/ 


rrp2 


ULONG Reserved 




return 


TRUE for handled and FALSE not handled 





□ 2-46 □ □ □ □ Tab □ □ □ 



□ □ □ □ □ MCD □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ 2-47 □□□□□□□□□□□□□□□□□□□， □□□□□□□□□□□□□ 

□ □□□□□□ DLL □□□□□□□□□, □□□□□□ MCD □□□□□□□□□□ 

□ □□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□ 



HWND InsertExanplePage(LPMCI— DEVICESETTINGS- PARMSpMCIDevSettings) 

{ 

HWND hwndPage; / * Page window handle 

CHAR szTabText [CCHMAXPATH] ; / * Buffer for tab string 
ULONG ulPageld; / * Page Identifier 









氺 氺 



*/ 



* Load a modeless secondary window . 






*/ 

*/ 



hwndPage = WinLoadS econdaryW indow ( 

pMCIDevSettings - 〉 hwndNot ebook r 
pMCIDevSettings - 〉 hwndNot ebook, 

E xairplePageDlgProc r 
vhmodMRI, 

ID. EXAMPLE, 

(PVOID)pMCIDevSettings); 
if ( ! hwndPage) return (NULL) ; 

ulPageld: (ULONG) WinSendMsg (pMCIDevSettings - > hwndNot ebook, 

BKM- INSERTPAGE, 

(ULONG) NULL, 

MPFR0M2SH0RT (BKA. AUTOPAGES I ZE I BKA. MINOR, BKA. LAST) ) ; 
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/ * Associate a secondary window with a notebook page . */ 

WinSendMsg (pMCIDevSettings - 〉 hwndNot ebook, BKM_ SETPAGEWINDOWHWND, 
MPFROMP (ulPageld) ^iyPFROMLONG(hwndPage) ) ; 

/ * Get tab text from DLL . */ 

WinL 〇 adString(WinQueryAnch 〇 rBl 〇 ck(HWND_ DESKTOP) ,vhm 〇 dMRI, 

(USHORT) IDB- EXAMPLE, CCHMAXPATH, szTabText) ; 

/ * Set tab text . */ 



WinSendMsg(pMCIDevSettings - 〉 hwndN 〇 teb 〇〇 k, BKM_ SETTABTEXT, 
MPFROMP (ulPageld) , szTabText) ; 
return(hwndPage) ; 



typedef struct { 

服 ND hwndHelpInstance; 

} MMPAGEINFO; 

typedef MMPAGEINFO * PMMPAGEINFO; 

/ * Modeless secondary window procedure */ 



MRESULT EXPENTRY ExairplePageDlgProc (HWND hwnd, USHORT msg,MPARAM,rtpl ,MPARAM rrp2) 
PMyPAGEINFOpiyiMPagelnfo: (PMMPAGEINFO) WinQueryWind 〇 wPtr(hwnd,QWL- USER); 



switch (msg) { 

case Wl. INITDLG: 

/ * Place window initialization code here . */ 

pMMPagelnfo = (PMMPAGEINFO) malloc (si ze 〇 f (MMPAGEINFO) ) ; 
WinSetWind 〇 wPtr(hwnd,QWL- USER,pMMPageInf 〇） ； 






* Create a help instance . */ 



pMMPagelnfo - > hwndHelpInstance = WinCre at eHelpIn stance (...); 
break; 




case Wi. DESTROY: 



/ * Clean up page window resources . */ 

WinDestr 〇 yHelpInstance(pMMPageInf 〇 - > hwndHelpInstance) ; 

free(piyiMPagelnfo) ; 

break; 

case 丽 - COMMAND: 



/ * Process all commands . */ 

return ( (MRESULT) FALSE) ; 
break; 



case MM. TABHELP: 

/ * Display help for a tab . */ 

if (pMMPagelnfo - > hwndHelpInstance) { 

WinSendMsg( 

pMMPagelnfo - 〉 hwndHelpInstance, 

HM. DISPLAY. HELP, 

MPFROMSHORT (WinQueryWindowUShort ( hwnd, QWS _ ID) ) , 

HM. RESOURCEID) ; 

} 

break; 



case Wi. CLOSE: 

return ( (ME^ESULT) FALSE) ; 
break; 

case WM- HELP: 

if (pMMPagelnfo - 〉 hwndHelpInstance) { 
WinSendMsg ( 

pMMPagelnfo - > hwndHelpInstance, 
HM. DISPLAY. HELP, 

(MPARAM)rrpl r 
HM. RESOURCEID) ; 

} 

return ( (MRESULT) TRUE) ; 
break; 

case Wl. TRANS LATEACCEL: 

return (WinDefWindowProc (hwnd^msg, rrpl , rrp2) ) ; 
break; 
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case HM. QUERY. KEYS. HELP: 

return( (MRESULT) IDH- HELPFORKEYS) ; 
break; 

} 

return (WinDefSec 〇 ndaryWind 〇 wPr 〇 c(hwnd,msg,rrpl,rrp2) ); } 



□ 2-47 □□□□□□□□ 
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□ 3〇 n □ □ □ 



□ □ □ □ □ MCD □□□□□□□□□□□□□□□□□ (Stream Programming In- 
terface, □ □ □ spi )〇 □□□□□□□□□□□□□□□ 



31 □□□□□□□□□ 



□ □□/□□□□ (ssm)Q □□□□□□□□□□□□□□□□□□□□□□□，□ 
□ □□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□a 〇 □□□□□□□□□□□,□□ 3DDDDDDDDD 

□ (DLL)：] □□ 3 .7 DLL : 3 .8 □□"□□□□□□ □ 

□ ：□ □ PDD"D □□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□ 

□ DLL, □□□□□□□□□ 3Q OS^2 

□ □□□□□ 

□ □□□□□□□□□□□□□□ (DLL □ DD)，[] □□□□□□□□□□□□□ 
□ □□□□□□□□□□□ 3-l，[] □□□ DLL □□□□□□□□□□□□□□□□□ 



□ 3-1 □□□□□□ 
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□ □□□ 0^2 DLL □□□□□□□□□□□□□□□□□□, □□□□□□□□ 

□ □□□□□□□□□□□□□□□□, dll □□□□□□□□□□□□□□□□□□ 

□ □□□□□□ 

□ 3-1 □□□□□/□□□ □ (SSM)D □□□□□□□□□□□□□□□□□□/□ 

□ □□DLL □□□□□□□□□□ (□□□□□□□□)□□ SPI □□，□□□□□□□ 

□ □ (stream Manger Helper,] □□ SMH )〇 □□□□□□□□ DLLQ □□□ SMH □ □ 

□ SSM □□□□□□□□□□ os^2DDDDDDDDDD (idc)D □□□□□□□□ 

□ □□□□□ (IDC[j □□□□ DevHelp— AttachDD □□ )□ 

□ 3-1 □□□ 0S/2DDDDDDDDDDD 

□ □：□□□ 〇 s/2DDDDDDDDDDDDDDDDDD,DDDD ADDD 

□ □□□□，，□ 



□ 3-1 OS2DDDDDDDDDDD 



□ □ □ □ 


□ □ 


□ □ 


□ □□□□□□□□□ VSD □□□□□ PCM, MIDI, ADPCM □□ □ 


MIDI □□□□□□ 


□ □□□ MIDI □□□□□□□□□□□□□□□□□□□□□/□□□□ 


□ □ 


□ □□□□□□□□□ 


□ □ 


□ CODEC □□□□□□□□□□□□□ 


□ □ □ □ 


□ □□□□□□/□□□□□□ 3 _4 □"□□□□□□□□『□ 


CD-ROM XA 


□ □ CI> ROM XA □□□□□□□□□□□□□□□□□□ 


CD- DA 


□ □□ CI>ROM □□□□□□□□□□□□□□□□□□□□□□ CD □ 




n n n n 



32 □ □ □ □ □ 



□□□□□□□□，□□□□□□□□□□□□□□□□□□□，□□□□□□□□ 

□ □□□)□□□□□ 〇 s/ 2DDDDD, □□□□□□□□□□□□□□□□□□□□ 
□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□□□□□□□□□，□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□(□□□□mo DMIDI □□□)□□□□□□□□□ 

□□□□□□□/□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□ 
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SpiStartStream, SpiStopStream, SpiSeekStream 〇 

■□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□ 口 

□ □ □ □ □ 

■□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□ 

□ □ □ 

□ □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□ (syncoverrun)Q □ □ □ 

□ □□□□□□ SSM 



□ 

□ 

□ 

□ 

□ 

)□ 

□ 

□ 

□ 

□ 
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□ 

□ 

□ 



□ ： 

■ □/□□□; 

■ □□□□□□□； 

■ □□□□□□□； 

■ □□/□□□□□□; 

■ □□□□□□□ 

□ □□□□□□□□ 〇 ^2DDDDDDDD, □□□□□□□□□□□□□□□ 
□□□□□□□□□□□□□□□ 
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□ □□□□□□□□□□□□□□□□□□□□□□□□(□[I SpiEnableEvent □□) 口 

322 □□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□ (HSTREAM)Q □ □ □ □ 

□ □ □ MMTiME(y 3DD)DDDD 〇 □□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □ □ □ □ 

□ □□□□□□□□□□□□□□□□□/□□□□ (SSM)Q □□□□□□□□□ 

□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

DLL 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□ SYNC. EVCBD □ 

□ /□□□□ (ssm)D □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□ (SYNC. EVCB)D □ □ □ □ 

□ □□□□□□□□□□ SYNC- EVCB □□□□□□,□□□□□□□□□□□□□□ 
SSM □□□□□□□ SSM 

□ □□□，□□□□□□□□，□□□□□□□□□□□□□□□□□□，□□□□ 
□ □ □ 

DLL □□□□□□□□□□□□□□□□□□□□□□□□ SSM □□□□□□□ 

□，□□□□□□□□□□□□□□□□□□□□□ 

323 □□□□□□ 

□ □□□□□ (DLL □□□□□□□)□□□□□□□□□□□□□□□□□□□ 

□ □□□□，□□□□□□□□□□□□ SYNC. EVCBQ □□□□□，□□□□□□□ 

□ □□□□□□□□□ SYNC- EVCB □□□□□□□,□□ SSM[| □□□□ □ 

□ 45000(0 MMTIMEQ □ □ 15. 0 □ ),□ □ □ 
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□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□，□□□□ 

□□□□□□□□□□ 

□ □/□□□□ (SSM)D 

□ □□□□□□□□□□ SYNCPOLLING □□□ (SSM □□□□□□□ 

□ □□□□□□□□□□□□□ dll □□□□□□□□ (□□□□□□□□□□□□ 

□ )□□□□□□,□□□□□□□□ SYNC. EVCBQ □ SYNCPOLLING □ Q Q ,DLL 

□ □□□□□□□□□□□□□□□□□□ SYNC. EVCB □□□□□□□□ SHC. 
ENABLE. SYNC □□□□□□ SSM □□□□□□□□□□□□□□□□□□(□□□ 

□ □ □ □ SYNC - EVCB □)□□□□□□□□□□□□ (resync tolerance value) □ ,□ □ 

□ SYNCPOLLING □□□□□□□□□□□□□□ ， SSM[| □□□□□□□□□□，□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□(□□□ MMTIME □□□□□□□□□)，□□□□□□ SPCB □ □ 

□ □□ SHC- CREATE □□□□□□□□ 

3 2 4 □□/□□□□□□ 

□□/□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□，□□□□□□□□□□□□ 

□□□□□□□：□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ (□□□□□□□□□□□□)□□□□□□□□□□□□□□□□□□□(□□□□ 

□ □□□□□□□□□，□□□ SpiEnableEvent □□□□□□□□□□□□□□□□□ 

□ □□□□□□□ SSM □□□□□□□□□□□ 

□ 3-2 □□□□□/ □□□□□□□□□□□□□□□□□□□□□□□□□，□□ 

□ □□□□□□□□□□□□□□□□□□ EVCB □□□□□□ ulType □ ulSubType 

□ □ ,DD 〇 s/2D □□□□□□□□□□ 



□ 3-2 □□/□□□□□□ 
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□ □□□□□□□□□ SpiCreatStream □□□□□ SSM □□□□□□□□□□□□□ 

□ □□□□□□□□□□□□，□□□□□□□□□□□□ 

□ □□□□□□□□□ EVCB,D □□□□□□□，□□□□□□□ EVCBD □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□： 



□nnnnnnnnnnn 



OVRU- EVCB 



EVENT. SYNCOYERRUN (〇 

□ ) 



G □ SpiStartStream Q Q )Q 



IMPL EVCB 



EVENT. SYNC. PREROLLED 

(□ □ ) 



SpiStopStream □ □ ) □ 



IMPL. EVCB 



EVENT. STREAM STOPPED 

(□ □ ) 



IMPL ■ EVCB 



EVENT _ QUEUE OVERFLOW 

(□ □ ) 



□□nnnnnnnnnnn 



PLAYL. EVCB 



EVENT . PLAYLISTMESSAGE 

(□ □ ) 



□nnnnnnnnnnnnnnnnnn 



PLAYL. EVCB 



EVENT. PLAYLISTCUE- 
POINT(D □ ) 



□□nnnnnnnnnnn 



IMPL EVCB 



EVENT. ERROR (□ □ ) 



□ □□□□□□□□□□□□□□□□□□ 口 

nnnnnnnnnnn 



IMPL EVCB 



EVENT. EOSfn □ ) 



□ □□□□□□□□□□□□□□□□,□□□ 
□ □□□□□□□□□□□□□, □□□□□ 
□ □□□□□□□□□□□，□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□ 



EVCB 



EVENT. DATAUNDERRUN 
(□ □ ) 



□ □□□□□□□□□□□□□□□□□□□ 
□ □□□□□□ 



EVCB 



EVENT. DATAOYERRUN ( Q 



EVENT - CUE- TIME- PAUSE TIME- EVCB □□□□□□□□□□□□□□□□□□ □口 

(□□) □□□□□□,□□□□□□□□□□□□□□ 

□ □ □ □ □ 



口 □ 



_ — _ D 

c c 

□ M 

□ ( 

□ □ 

□ □口 

□ □ n 

□ □ n 

□ □ n 

□ □ n 

□ □ n 

□ □ n 

□ □ n 

□ □ n 

□ □ n 

□ □ □ 
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I Event - Entry ( PEVCB, pEVCB, rc) | 

325 □□□□□□ 

ssm 

□ □□□□□□□□□□□□□□ CI>DA □□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□，□□□□□□□□□□□□ SpiGetProtocol □□□ SpilnstallProtocol □□□□ □ 

□ □，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□El SPCB □□□□ □ 

□ □，□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□ (SHC)D □ : 

■ SHC. CREATE 

■ SHC. DESTROY 

■ SHC. DISABLE. EVENT 

■ SHC. DISABLE. SYNC 

■ SHC. ENABLE. EVENT 

■ SHC. ENABLE. SYNC 

■ SHC. ENUMERATE. PROTOCOLS 

■ SHC- GET PROTOCOL 

■ SHC. GET TIME 

■ SHC - INSTALL PROTOCOL 

■ SHC. NEGOTIATE - PROTOCOL 

■ SHC- SEEK 

■ SHC. START 

■ SHC- STOP 

33 □ □ □ 

□ □□□□□ (SPCB)D □□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□ SPCBD SPCB □□□□□□□□□□□□□ SPI .INI 



□ 
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□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ SPCB(D □ SPCBKEY 

□ □□□□□ ulType □□)□□□□□□□□□□□□□ SPCB □□□□□□ SPCB □ 

□ □□□□□ 

SPCB □ □ □ □ : 



SPCB Length 
SPCB Key 



Data Flag 



Number of Records 
Data Block Size 



Data Buffer Size 
Min Number of Buffers 



SPCB □□□□□，□□□□□□ SPCB 口 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□a 

□ □ □ SPCBD 

■ Data Type □□□□□□(□□ ,□□□ MIDI ) ; 

■ Data Subtype □□□□□(□□ 16 □□□□ PCM) 口 

■ Internal Key □□□□□□□□□□□□□□□□□ SPCBQ 

□ □□□□□□(□□□□□□□□□□□□□□□□□□□□□□ 
□ □) 

• SPCBDATA. CUETIME —— □□□□□□□□□□□□□□□□□ 

■ SPCBDATA. CUEDATA — — □□□□□□□□□□□□□□□□□ 

■ SPCBDATA. NOSEEK — — □□□□□□□□□□□□□ 

□□□□□□□□□□□□(□□□□□□□)□ 

□ □□□□□□□□□□□□□□□□,□□□□□□□ 44 .lkHzD 16 

□ □□□□□□□□□□□ PCM, □□□□□ 4 〇〇〇 □) 

□ □□□□□□□□□□□□□□□，□□□□ 64KB 〇 

□ □□□□□□□□□□□□□□□□□□□□ 



Max Number of Buffers 

□ □□□□□□□□□□□□□□,□□□ SSM □□□□□□□□□□ 

□ □□□□□□□□□□□□□□ SSM 

□ □□□□□□□□□□□□□□□□□□□□□□ !,□□□□□□ 

□ □ □ 

Source Start Number □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□ 

Target Start Number □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □ □ 

Buffer Flag □□□□□(□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□)□ 

■ SPCBBUF. USERPROYIDED —— □□□□□□□□□□□□ SSM □ 

□ □□□□□,□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□ SPCBBUF— INTERLEAVED □□□□□□□□ 

□ □□□ ,□□□□ SPCBBUF. FIXEDBUFD 
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Handler Flag 



Resync Tolerance 
Sync Pulse Granularity 



Bytes Per Unit 



■ SPCBBUF— FIXEDBUF —— □□□□□□□□(□□□□□□□□)□ 

□ □□□□□□□□□□□ SPCBBUF- USERPROVIDED □□□□ □ 
SPCBBUF- INTERLEAVED □□(□□□)□□□□□ SPCBBUF - 
FIXEDBUFQ 

■ SPCBBUF- NONCONTIGUOUS —— □□□□□□□□□□□□□□ 

□ □□，□□□□□□□□□□□□□□ (SPCBBUF- NONCON- 

TIGUOUS)D □□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□,□ DLL □□□□□□□□□ 

■ SPCBBUF. INTERLEAVED —— □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□ SPCBBUF— USERPROVIDED □ □ 

□ □□□□□□□□□,□□□□ SPCBBUF. FIXEDBUFQ 

■ SPCBBUF- MAXSIZE —— ulBufSize □ □□□□□□□□□□□□□ 

□ □□□□□□ 

■ SPCBBUF— 16MEG — — □□□□□ 16MB □□□□□□□□□□□□ 

16MB □□□□□□□□□□□□□□□□□□□ 

□ □□□□□(□□□□□□□□□□□□□□,□ SSM □□□□□□ 

□□□，□□□□□)□ 

■ SPCBHAND GENSYNC — — □□□□□□□□□□□□□ 

■ SPCBHAND RCYSYNC — — □□□□□□□□□□□□□ 

■ SPCBHAND NONSTREAM —— □□□□□□□□□□□□□(□□ 

■ SPCBHAND. GENTIME —— □□□□□□□□□□□□□□□□□ 

□ □□□□□ SpiGetTime □□□□□□□□□ 

■ SPCBHAND NOPREROLL —— □□□□□□□□□□□□□(□□ 

□ ,ssmd □□□□□□□□□□□□)□ 

■ SPCBHAND NOSYNC — — □□□□□□□□□□□□□□□□□□ 

□ □) 

• SPCBHAND PHYS- SEEK —— □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□ 

SpiSeekStream □□□ ,SSM □□□□□□□□□□□□ 

□ □ □ □ □ 

□ □□□□□□□□□□□□,□ MMTIME □□□□□□□□□□□ 

□ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ □ SHC. GETTIMED □ □ 
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MMTIME Per Unit 



□ □□□□□ MMTIME □□□□□□□□□□□□□□□"get time” 

□ □ □ 



□ □□□□□□□□□□□□□□,□□□ 〇 s/ 

331 □□□□□□□□□□ 

□□□□□□□□□□□□□□□： 

■ □ □ □ □ SPCB □□□□□□□□□□，□□□□□□□□□□□□□□□□□ 

□ □ □ □ SPCB □□□□□□□□： 

SPCB HAND GENS YNC SPCB HAND RCV SYNC 
SPCB HAND GENTIME SPCB HAND PHYS. SEEK 

■ □□□□□□ DATATYPE - GENERIC □□□□□□□□□□□□□□□□□□ 

■ □ □ SPCB □□□□□□□□□□□□□，□□□□□□□□□□□□□□□，□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
〇□ 

■ □□□□□，□□□□□□□□□□ !□□□□□□□□□□□□□□□，□□□ 
□ □ □ □ 

' □□□□□□□□□□□□□□□□□ 

■ □□□□□□□□□□□□□□□□ (SPCBBUF— FIXEDBUF )〇 □□□□□□ □ 

□ □□□□□□ (SPCBBUF— MAXSIZE)[] □□,□□□□□□ 

■ □□□□□□□□□□□□□□□□□□□□ (SPCBBUF- FIXEDBUF)Q 

■ □□□□□□□□□□□□□□□□□□□□ (SPCBBUF- MAXSIZE)Q 

■ □□□□□□□□□□□□□□ (SPCBBUF- FIXEDBUF)：] □□,□□□□□□ 

□ □ □ □ □ SPCB □□□□□□□□□□□，□□□□□□□□□□□ (SPCB- 
BUF—MAXSIZE)，[] □□□□□□□□□□□ 

■ □□□□□□□□□□ (SPCBBUF FIXEDBUF, SPCBBUF MAXSIZE ， SPCB- 
BUF — USERPROVIDED),[] □□□□□□□□□□□□□ 

■ □□□□□□□□□ (SPCBBUF— USERPROVIDED), □ □□□□□□□□□□ 

□ □□□ (SPCBBUF— MAXSIZE)，[] □□□□□□□□□□□□□□□□□□□ 

□ □ 

■ □□□ (SPCBBUF — INTERLEAVED)：] □□□□□□□□□□□□□□□,□□ 

■ □□□□□□□□□□□□□〇□ 

' □□□□□□□□□□□□□□ 

' □□□□□□□□□□□□□□ 

■ SSM □□□□□□□□□□□□□□□□□□□□□□□□□, □□□□□□□ 
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■□□□□□□□□□□□□□□□□ SPCB □□□ □ 
■□□□□□□□□□□□□□□□□□□ SPCB □□□ □ 

■ SpiGetTime □□，□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□ SPCBHAND- GENTIME 

□ □□□□□□，□□□□□□□□□□□□□ 

1 □□□□□□□□ MMTIME □□□□□□□□，□□□□□□□□□□□□□ 

□ □ □ 

■ □□□□□□□□□□□□□□□□□□□□□□□□□□□□ SPCB HAND 
GENSYNC：! SPCBHAND— RCVSYNC[] 

■ □□□□□□□□□□ SPCBHAND— RCVSYNCEl □□□□□□□□ 

■ □□□□□□□□□□□ SPCBHAND— GENSYNC □□□□□□□□□ 

■ SPCBHAND— PHYS— SEEK □□□□□□□□□□□ SHC- SEEK □□□□□ □ 

□ □□□□□□□□ SSM □□□□□□□□ SpiSeekStream □□□□□□□□□ 

□ □□□□□□□，□□□ SPCBHAND - GENTIME □□□□□□□□□□□□ 

□ □ 

' □□□□□□□□□□□ NULLD 

■ □□□□□□□□□□□□□□□□□□□〇□ 

34 □□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ (System 
Memory Stream Handler) [] □□□□□□0 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□，□□□□□□□□□□□□□□□□□□□□ CUEPOINT □ □ , 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□" □□"□，□ □□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □ 

SSM □□□□□□□□□□□□□，□□□□□□ SSM □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ (□□□〇^2〇〇 

□ □□□□□□□ SMH_ NOTIFY □□)□□□□□□□□□□□□□□ 0□□□□□ 

□ □，□□□□□□□□□□(□□ EVENT — CUE— DATA)[] □□ SSM □□ SMH— RE- 
PORTEVENT □□□,□□□□□□□□□□□□□□□□ 
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□ □□□□□□□□□□□□□□,□□□ 〇 s/ 

3 5 CI>ROM XAD □ □ □ 

SSM □□□□□□□□□□□□□ ， □□□□□□□□□□□□□□□□□ ， 0> 
ROM XA □□□□□□□□□□□□□□□□□□□□□□□ CI> ROM XA □□□□ □ 
CD-ROM XA 

□ □□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□ 
□ □□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□ 

□ □□□□□□□□□□□□□ SSM □□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ ssmd 

□ □ □ SSM, □ SSM □□□□□□□□□□□□□ SSM □□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□ 

SpiCreateStream □□□□□□□□□□□□□□□□□□□□□□□□□，□ hstream- 
Buf[] □□□ NULL[] □□□□□ SpiCreateStream □□□□□□□□□□□□□□，□ 

□ □□□□□□□□□□□□□□ hstreamBuf □□□□□□ SSM □□□□□,□□□ 

□ □□□□□□□□□□□□□□□ 

□ □□□□□ SHC— CREATE：] 

□ □□□□□□ SPCB □□□□ SPCBBUF— INTERLEAVEO □□□□□□□□□□□ 

□ SpiCreateStream □□□□□□□□□□□□□□□□□ 

□ □□□□□□□，□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□mDDDDDD 

3.6 □ □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□ spi □□□□□□□□□□□□□□ 

□ □ □ □ 
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361 □□□□□□□□□□□□□ 



□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□(□□□□□□□a dldd □□□□,□□□□□□□□□□□□□□□□□□ 

3 2D □ 
















氺 氺氺氺 



氺氺氺 / 




MAIN 



*/ 



氺 















氺 氺氺氺 氺氺氺 y 



# include 


< os2 h > 


# include 


< stdlib h > 


# include 


< stdio h> 


# include 


< conio h > 


# include 


< st ring h > 


# include 


〃〇 s2me *h" 



main ( ) 



RC ulRC; 

SPCBKEY SPCBkey; 

工 MPL_ EVCB EVCB; 

ACB. MMIO acb; 



/ * Error return code */ 

/ * Data type to stream*/ 

/ * Event control block for irrplicit events */ 
/ * Associate control block used to assoc */ 



DCB- AUDIOSH 

HAND 

ULONG 



deb; 

ahand[5 ] ; 
ulNumHand = 5 ; 



/ * The file to stream (play) */ 

/ * Audio device driver information */ 
/ * Enumerate handler info */ 



HID hidS 〇 urce,hidTarget, hidunused;/ * Handler ID * / 

HSTREAM hstream; / * Stream handle */ 



HEVENT hevent; / * Event handle for irrplicit events */ 

HMMIO hrtimioln; / * Handle to mmio file open */ 

/ * Get list of all stream handlers in system*/ 



if (rc = SpiEnumerateHandlers ( &ahand, & ulNumHand) ) 



return ( rc) ; / * error ! */ 

/ * Get the stream handler ID for the File System Stream Handler */ 
if (rc = SpiGetHandler (’’FSSrf’ ， &hidS 〇 urce, &hidunused) ) 



return ( rc) ; / * error ! */ 

/ * Get the stream handler ID for the Audio Stream Handler */ 
if (rc = SpiGetHandler ( 〃 AUDI 〇 SH[] 〃， &hidunused, &hidTarget) ) 
return ( rc) ; / * error ! */ 

/ * Create a data stream from the file system to the */ 

/ * waveform audio AGPA device connected t 〇 speakers •*/ 
SPCBkey nlD at aType = DATATYPE- WAVEFORM; 
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SPCBkey ^lDataSi±)Type = WAVE. FORMAT. 4S16; 

SPCBkey ulINtKey: 0; 
strcpy(dcb .szDevName/'AUDIOlQ ff ) ; 
deb .ulDCBLen = sizeof (deb) ; 

deb .hSysFileNum= ( * * hSysFileNum returned by audio dd on audio, init call) 
if (rc = SpiCreateStream(hidS〇urce, 

hidTarget, 

& SPCBkey, 

NULL, 

(PDCB) &dcb, 

(PEVCB) &EVCB, 

EventProc, 

&hstream, 

&hevent) ) 

return ( rc) ; / * error ! */ 

/ * USE MMIO to access a waveform audio object */ 

if ( (hmmioIn = rrimioOpenrc: \ lawton \ files \ waveform \ hendrix .jiuT 

NULL, 

剛工〇_ READER ITE I 
剛工〇_ DENYNONE) ) = = NULL) 
return(ERR〇 R-FILE_N 〇 T_F 〇UND); 

/ * Fill in acb with data object info */ 
acb .ulACBLen= sizeof (ACB- MMIO) ; 
acb .ulObjType = ACBTYPE. MMIO; 
acb .hmmio = hmmioln; 

/ * Associate the waveform data object with the source handler */ 
if (rc = SpiAssociate (hstream^hidSource, &acb) ) 
return ( rc) ; / * error ! */ 

/ * Start the streaming*/ 

if (rc= SpiStartStream(hstream,SPI. START. STREAM)) 

return ( rc) ; / * error ! */ 

/ * Do other processing*/ 

/ * Create a semaphore and block this thread on the semaphore */ 

/ * until the streaming is corrplete */ 



/ * Destroy the stream*/ 
if ( rc = SpiDestroyStream (hst ream) ) 
return ( rc) ; / * error ! */ 
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/ * Perform any other resource cleanup */ 



* Event Procedure 氺 / 

氺 



RC EventProc (EVCB ^ pEVCB) 



/ * Handle events from the Sync/ Stream Manager */ 

Switch (pEVCB - > ulType) { 

case EVENT- IMPLICIT- TYPE: 

switch (pEVCB - > ulSubType) { 

case EVENT. EOS: / * End of Stream*/ 

/ * Clear the semaphore so that the main */ 

/ * routine can continue execution . */ 

break; 

case EVENT. ERROR: / * Error occurred */ 

/ * flag error condition in main line application */ 
break; 

case EVENT- STREAM- STOPPED: / * Discard Flush Stop */ 

/ * Do processing while stream stopped */ 
break; 

case EVENT- SYNC- PREROLLED: / * Stream is prerolled */ 

/ * Now that the producers are prerolled, do a real 
start to the stream handlers */ 
break; 

default: 

/ * Unknown event, do something */ 

} 

break; 

default : 

/ * Unknown event , do something */ 

} 



□ 3-2 □□□□□□□□□□□ 

3 J6 2 □ □ □ □ MIDI □ □ □ □ 

□ □□□□□□□□□□□□(□□□□ midi), □ □□□□□□□□□□□□□ 

□ □□，□□□□□□□□□□□□□□□□□ DLLQ midi □□□□□□□□□□□ 

□ □ □ □ DLLD 
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□ □ □ □ 3-3 □ □ 



/ 氺 MAIN 氺 / 

main ( ) 

{ 

RC ulRC; 



* Error return code */ 



SPCBKEY 
工 MPL_ EVCB 
ACB. mio 

DCB. AUDIOSH 

HAND 

ULONG 



spcbkey; 
evcbl f evcb2; 
acb; 

deb; 

ahand[5 ] ; 
ulNumHand = 5 



/ * Data type to stream*/ 

/ * Event control block for irrplicit events */ 
/ * Associate control block used to assoc */ 

/ * The file to stream (play) */ 

/ * Audio device driver information */ 

/ * Enumerate handler info */ 



HID hidSourcel , hidTargetl ,hidunused; / * Handler IDs */ 

HID hidSource2 f hidTarget2 

HSTREAM hstreaml ,hstream2;/ * Stream handle */ 

HEVENT hevent 1 , hevent2 ; / * Event handle for irrplicit events */ 

HiyiMIO hrtimiol ,hrrimio2; / * Handle to mmio file open */ 

SLAVE slave [ 1 ] ; / * Sync slave structure */ 



/ * Get list of all Stream handlers in system*/ 
if (rc = SpiEnumerateHandlers ( &ahand, & ulNumHand) ) 
return ( rc) ; / * error ! */ 

/ * * * * * CREATE WAVEFORM AUDIO STREAM (Stream# 1) *************/ 

/ * Get the stream Handler ID for the file system stream handler */ 
if (rc = SpiGetHandler ("FSStf , &hidS 〇 urcel , &hidunused) ) 
return ( rc) ; / * error ! */ 

/ * Get the stream handler ID for the Audio Stream Handler */ 
if (rc = SpiGetHandler T AUDIOS H [] f &hidunused A & hidTargetl) ) 
return ( rc) ; / * error ! */ 

/ * Create a data stream from the file system to */ 

/ * the audio ACPA device connected to speakers . */ 

spebkey jjlDataType = DATATYPE. AD PCM. AVC; 

spebkey jjlDataSabType = ADPCM. AVC- HQ; 

spebkey ^ulINtKey: 0; 

strcpy(dcb .szDevName TaudioIQ ，f ) ; 

deb .ulDCBLen = sizeof (deb) ; 

deb .hSysFileNum= ( * * hSysFileNum returned by audio dd on audio, init call) 
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if ( rc = SpiC reateSt re am ( hidS ource 1 , 

hidTargetl, 

& spcbkey , 

NULL, 

(PDCB) &dcb, 

(PEVCB) &evcbl, 

EventProc, 

&hstreaml, 

&heventl) ) 

return ( rc) ; / * error ! */ 

/ * USE MMIO to access a waveform audio object */ 

if ( (hmmiol = mmioOpen (〃E: \ Mygreat \ waveform \ file \ screams «hq" 

NULL, 

MV [工 〇_ READWRITEl 
MMIO. DENYNONE) ) = = NULL) 
return (ERROR. FILE. NOT. FOUND) ; 

/ * Fill in acb with data object info */ 
acb . ulACBLen = sizeof (ACB- MMIO) ; 
acb .ulObjType = ACBTYPE. MMIO; 
acb .hmriio = hmmiol ; 

/ * Associate the waveform data object with the source handler */ 
if ( rc = SpiAssociate (hstreaml , hidSourcel r &acb) ) 
return ( rc) ; / * error ! */ 

/***** CREATE MIDI STREAM (Stream# 2) *************/ 

/ * Get the stream handler ID for the File System Stream Handler */ 
if ( rc = SpiGetHandler ("FSS tf , &hidS〇urce2 , &hidunused) ) 
return ( rc) ; / * error ! */ 

/ * Get the stream handler ID for the MIDI Audio Stream Handler */ 
if (rc = SpiGetHandler (〃AUDI〇SH[] ", &hidunused, &hidTarget2) ) 
return ( rc) ; / * error ! */ 

/ * Create a data stream from the memory to an */ 

/ * OEM audio device connected to speakers . */ 

spcbkey *1110&七&丁沙6 = DATATYPE — MIDI; 
spcbkey jjlDataSubType = SUBTYPE. NONE; 
spcbkey ;ulINtKey= 0; 
strcpy(dcb.szDevName,"AUDI〇 99[]"); 
deb .ulDCBLen = sizeof (deb) ; 

deb .hSysFileNum= ( * * hSysFileNum returned by audio dd on audio- init call) 
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if ( rc = SpiCreateStream(hidS 〇 urce2, 

hidTarget2, 

& spcbkey , 

NULL, 

(PDCB) &dcb, 
(PEVCB) &evcb2, 
EventProc, 

&hstreain2, 
&hevent2) ) 

return ( rc) ; / * error ! */ 



/ * USE MMIO to access a waveform audio object */ 

if ( (hmmi 〇 2 = mmioOpen ( 〃 E: My great \ midi \ file \ screams micf 

NULL, 

MMI 〇 - READ WRITE I 



MMIO. DENYNONE) ) = = NULL) 



return (ERROR. FILE. NOT. FOUND) ; 

/ * Fill in acb with data object info */ 
acb .ulACBLen= sizeof (ACB. MMIO) ; 
acb .ulObjType = ACBTYPE. MMIO; 



acb .hrtimio = hmmio2; 

/ * Associate the waveform data object with the source handler */ 
if ( rc = SpiAssociate ( hstreain2 , hi dS 〇 urce2 , & acb) ) 
return ( rc) ; / * error ! */ 

/ * * * * SETUP THE SYNCHRONIZATION BETWEEN THE TWO STREAMS * * 



slave [ 0] «hSla veSt ream = hstream2; 

slave [ 0] irmtimeStart = 0 ; 

if ( rc = SpiEnableSync (hstreaml r 

& slave. 



/ * MIDI stream is slave */ 

/ * Time to start slave */ 

/ * Audio stream is master */ 

/ * Number of slaves */ 



〇)) 

return ( rc) ; / * error ! */ 



/ * Use spcb sync granularity */ 



/ * Start streams by passing the handle to the stream sync master */ 
if (rc= SpiS tart St ream (hstreaml, SP I - START- SLAVES) ) 



return ( rc) ; / * error ! */ 

/ * Do other processing*/ 



/ * Create a semaphore and block this thread on the semaphore */ 




/ * until the streaming is corrplete 



*/ 



/ * Destroy both streams when corrpleted */ 
if ( rc = SpiDestroyStream (hst reaml ) ) 
return ( rc) ; / * error ! */ 

if ( rc = SpiD estroyStr earn (hst reain2 ) ) 
return ( rc) ; / * error ! */ 

/ * Perform other resource cleanup */ 

} 

/ * Event Procedure 

RC EventProc (EVCB * pEVCB) 

{ 

if (pEVCB = = &EVCB1 ) / * Stream # 1 or Stream # 2 event ? */ 

/ * Proces s Stream # 1 events * / 
else 

/ * Process Stream # 2 events * / 

/ * Handle events from the Sync/ Stream Manager */ 
switch (pEVCB - > ulType) { 
case EVENT- IMPLICIT- TYPE: 

swich (pEVCB - > ulSubType) { 

case EVENT- EOS: / * End of Stream * / 

/ * Clear the semaphore so that the main routine can */ 
/ * continue execution . */ 

break; 

case EVENT. ERROR: / * Error occurred * / 



/ * flag error condition in main line application */ 
break; 

case EVENT. STREAM. STOPPED: / * Discard Flush Stop */ 

/ * DO processing while stream stopped */ 
break; 

case EVENT- SYNC. PREROLLED: / * Stream is pre rolled */ 

/ * Now that the producers are prerolled, do a real 
start to the stream handlers * / 
break; 
default: 

/ * Unknown events do something */ 

} 

break; 



default: 




/ * Unknown events do something */ 



□ 3QD 2 API 

□ □□□□□□□□□□□□□□□□ pddq 

371 □□□□□□□□□□ 

□ 3-4 □□□□□□□□□□□ (FSSHT .DLL)[] □□□□□□□□□□□ □□口 

□ □□□□□□□ 3-3Q 



M 3-3 □ □ □ □ MIDID Li [」 U 
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□ 3-4 □□□□□□□□□□ 





□ 3-3 □□□□□□□□□□□□ 



□ □ □ 


□ □ 


SHINT .C 


□ □□ FSSHT .DLL □□□□□，□□□□□□□: 

• DLL— INITTERM □□□□□□□□□ SSM 

• SHEXITLIST 


SHROUTER .C 


□ SSM □□□□□□□□ (SHC)D □□□□□□□□□□□□□ 


FSSHASS .C 


□ SHC— ASSOCIATE^ 

□ □ ,CI>ROM □□□□□)□□□□□□□□□□□□ 


SHEPROT .C 


□ □ SHC- ENUMERATE 

□ □ 


SHGPROT .C 


□ SHC- GET— RROTOCOL 

□ □□□□□□□□□ (SPCB)Q 


SHIPROT .C 


□ SHC— INSTALL— PROTOCOL 

□ □□□□□□□ SPCB 口 


FSSHCREA .C 


□ SHC- CREATED □□□□□□□□□□□ ，□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□，□□ fsshread .C □□□ □ 

□ □□□□□□□ FSSHWRIT . 〇 □□□□□□□□□ 


SHNEGOT .C 


□ SHC. NEGOTIATE— RESULT □ □□□□□□□□□□□,□□□□□ 

□ □□□□□□□□□ spcbd 


SH START .C 


□ SHC- START □□□□□□□□□□□□；□□□□□□□□□□□□□ 

□ □□□□□□，□□□ FSSHREAD 

□ FSSHWRIT .C □□□□□ □ 


SHSTOP .C 


□ SHC— STOP 

□ (STOP DISCARD), □ □ 

□ □□ SSM(STOP FLUSH)] □□□□□□□□,□□□ FSSHWRIT 

□□□□,□□□□□□□□□□□ 


FSSHSEEK .C 


□ SHC- SEEK □ 

□ □□□□□[□□□□□□□□□□□□□□□□□□□ MMTIME □ □ 

□ □□□□□□□□□ SEEKCALC .ASM 

MMTIME mmioSeek 

□ □□□□□□ 


SEEKCALC ASM 


□ □ FSSHSEEK €□□□□□ MMTIME □ □□□□□□□□□ MMTIME 

□ □ □ □ 


SHDESTROY .C 


□ SHC- DESTROY □□□□□□□□□□□□，□□□□□□□□□□□ 

□ □□□□,□□□ FSSHREAD .C □□□□□□ FSSHWRIT .C □□□ □ 
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□ □ 



□ □ □ 


□ □ 


SHMISC .C 




■ 


□ □□□□□□□□□□□□□□ FSSHCREA .C □□□□ SHC- CREATE 

□ SHDESTRY .C □□□□ SHC- DESTROY 

□ □□□□□□□□□□□□□□□□ SHIOUTIL .C □□ mmioRead □ □ 

□ □□□□□□□□□□，□□□□□□□□□□□ SSM □□□□□ 


SHIOUTIL .C 


FSSHREAD .C □ FSSHWRIT £：□□□□□□□□□□□□□□□□□□ 
□ □□□□□□ SSM □□□□□□□ 


FSSHDAT .C 


□ □□□□□□□□□□□ 


makefile 


□ □ FSSHT .DLL □□□□□□□□□□□ make □□ □ 



372 □□□□□ 

ssmddddd os/ 2 〇〇〇〇〇 (□□□□□□□□)□□ spiddddd ssm 

□ □□□□□□□□□ dllq □□□□□ OS/2DDDDDDDDDD (idc)D □ ,ssm 

□ □ □ □ SMH □□□□□□□□□□□□□□□□ IDC □ □ □ □ DevHelp. AttachDO 

□ □ □ □ □ 



□ 3-5 DLL □□□□□□ 



3 .7 3 SMHEntryPOint 

□ □ SMHEntryPoint，[] □□□□□□ DLL □□□□□□□□ SMH □□□□□ □ 

□ □□□□□□□□□□ SSM 

□ □□□□□□□□□，□ 3 〇 [] DLL □□□□□□□□□□□□ DLL □□□□□( □ 

□ 〇 □□□□□□□□□□□ IDC □□)□ 

3 .7 4 SHCEntryPOint 

□ □□ 3-6 DLL □□□□□□□□□□□□□□□□□□□□ DLL □ □ 

□ □□□□□□□□□□□□ SSM □□□□□□□□□□□□□□□□( SHC) □ □ □ 
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ssm □□□□□□□□□□□□□□ (SHC)Q □□□□□□□□□□□ shcdddd 
□ □□□□□□□ SHCEntryPoint □□□ □ 



RC ShcRouter (pshc) 

PSHC_ C 〇 My 〇 NpshcN 〇 w; 

{/ * Start of ShcRouter */ 

RC rc = NO. ERROR; / * local return code */ 

switch (pshc - > ulFunction) 

{ 

case SHC. ASSOCIATE: 

{ 

rc = ShcAssociate ( (PPARM- ASSOC) pshcNow) ; 
break; 

} 

case SHC. CREATE: 

{ 

rc = ShcCre ate ((PPARM_ CREATE) pshcNow) ; 
break; 

} 

case SHC. DESTROY: 

{ 

rc = ShcDes troy ((PPARM- DESTROY) pshcNow) ; 
break; 

} 

case SHC. SEEK: 

{ 

rc = ShcSeek( (PPARM- SEEK) pshcNow); 
break; 

} 

case SHC. START: 

{ 

rc = ShcStart ( (PPARM. START) pshcNow) ; 
break; 

} 

case SHC. STOP: 

{ 

rc = ShcStop( (PPARM. STOP) pshcNow) ; 
break; 
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case SHC. GET. PROTOCOL: 



rc = ShcGet Protocol ( (PPARM. GPROT) pshcNow) ; 
break; 

} 

case SHC- INSTALL. PROTOCOL: 

{ 

rc = ShcInstallPr 〇 t 〇 c 〇 l( (PPARM- INSTPROT) pshcNow),- 
break; 

} 

case SHC. ENUMERATE. PROTOCOLS: 

{ 

rc = ShcEnumerateProtocols ( (PPAPM- ENUMPROT) pshcNow) ; 
break; 

} 

case SHC. NEGOTIATE. RESULT: 

{ 

rc = ShcNegotiateResult ( (PPARM— NEGOTIATE) pshcNow) ; 
break; 

} 

default : 

{ 

rc = ERROR. INVALID. FUNCTION; 
break; 

} 

} / * endswitch */ 
return ( rc) ; 

} / * End of ShcRouter * / 

□ 3-6 SHROUTER .C □ □ □ □ SHC □ □ 

3 7 5 DLL □ □ □ 

□ 3-7 □□□ DLL □□□□□□□□□□□□□□□□□□ ，□□□□□□□□□ 

□ □ DLL □□□□□□□ DLL □□□□□□, □□□□□□□□□□□□□□□□□□ 

dll □□□□□□□□□□□□□□□□□□□□□, □□□□□□□ ssmdddd 

□ □□ DLL □□□□，□□□□□□□□□□□□□□□□ 

ULONG- DLL- Ini t Term (HMODULE hmod,ULONG fTerm) 

{ / * Start of Shlnit * / 
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RC rc = NO . ERROR; / * local return code * / 

PARM. REG smhRegParm; / * Parameters for SMH. REGISTER*/ 

int Registered = FALSE; 

int HeapAl located. Attached = FALSE; 

int GlobDataMtxCreated= FALSE; 

hmod; 

/ * 

* Checking this parameter will insure that this routine will only 

* be run on an actual initialization . Return success from the 

* termination . 

*/ 



if (fTerm) 

{ 

return ( 1 L) ; 

} 

if ( . CRT. init () ) 

{ 

return ( 〇 L) ; 

} 

/ * 

* Get the semaphore controlling the process count and update the process 

* count if successful .Then after we have the sem, if the count is 1 , 

* we are guaranteed that we must do the global initializations . 

氺 

* There is a problem . To determine if we need to create or open the 

* semaphore, we need to check the ProcessCount to see if this is the 

* first process But since we dori t have the semaphore, we don t have 

* a guarantee the count won t change . If we get caught in this window 

* then we will fail to get the semaphore and the rc will indicate error . 
*/ 

if (ulProcessCount = = 0) 

{/ * First process */ 

if ( ! ( rc = DosCreateMutexSem (pszProcCntMutexName, 

& hmtxProcCnt , 

〇 L, 

TRUE) ) ) 

{ 

ulProcessCount + + ; 

} 

} / * First process */ 
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else 



{/ * not first process */ 

/ * if a process exits and decrements ProcessCount before we get */ 

/ * the semaphore here, we will fail .*/ 
if ( ! (rc = DosCpenMutexSem(pszProcCntMatexName f 

&hmtxProcCnt) ) ) 

{ 

if ( ! (rc = DosRequestMutexSem (hmtxProcCnt, 

SEM- INDEFINITE. WAIT) ) ) 

{ 

ulProcessCount + + ; 

} 

else 

{ 

DosC loseMutex Sem (hmt xProcCnt ) ; 

} 

} 

} / * not first process */ 
if ( ! rc) 

{ / * Semaphore ok. In critical section */ 

/ * 

* If this is the first time this init routine is called then we are 

* being brought in by the loader the first time A so we need to 

* register with the SSM . 

*/ 

if (ulProcessCount = = 1 ) 

{ / * First process */ 
smhRegP am ulFunction: SMH_ REGISTER; 
smhRegParm pszSHName = pszHandlerName; 
smhRegParm phidSrc= &SrcHandlerID; 
smhRegParm phidTgt = &TgtHandlerID; 
smhRegParm pshcfnEntry = (PSHCFN) ShcRouter; 

smhRegParm ul Flags = 〇 L; 

if (ulHandlerFlags & HANDLER. CAN. BE. SOURCE) 

{ 

smhRegPam .ulFlags = REGISTER- SRC- HNDLR; 

} 

if (ulHandlerFlags & HANDLER- CAN- BE- TARGET) 

{ 

smhRegParm .ulFlagsl = REGISTER. TGT. HNDLR; 
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if (ulHandlerFlags & HANDLER. IS. NONSTREAMING) 

{ 

smhRegParm .ulFlagsl = REGISTER. NONSTREAMING; 

} 

rc = SMHEntryPoint ( (PVOID) &smhRegPam) ; 

/ * 

* If ok then allocate our memory pool (heap ) , since it is under 

* semaphore control create and get the semaphore first . 

*/ 

if ( ! rc) 

{/ * Register ok */ 

Registered = TRUE; 

hHeap = HhpCreateHeap (HEAPSIZE, HH. SHARED) ; 
if (hHeap) 

{ / * Heap Allocated */ 

Heap A1 located . Attache d = TRUE ; 
if ( ! (rc= DosCreateiyEatexSem(NULL A 

& hmtxGlobalData, 

DC. SEM. SHARED, 

FALSE) ) ) 

{ 

GlobDataMtxCreated= TRUE; 

} 

} / * Heap Allocated * / 
else 

{ / * Heap not allocated*/ 
rc = ERROR. ALLOC. RESOURCES; 

} / * Heap not allocated*/ 

} / * Register ok */ 

} / * First Process */ 
else 

{/ * Not first process */ 
if ( ! (rc = Dos CpenMjtexSem (NULL, 

&hmtxGlobalData) ) ) 

{ / * Global data semaphore opened * / 

GlobDataMtxCreated= TRUE; 

if ( ! ENTERCRIT(rc) ) 

{/ * Global Data Sem obtained*/ 

i f (HhpAccessHeap (hHeap, HhpGetP ID ()) ) 

{/ * Error accessing heap */ 
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rc = ERROR. ALLOC. RESOURCES; 



} / * Error accessing heap * / 
else 

{/ * Heap attached */ 

Heap Allocated- Attached = TRUE; 

} / * Heap attached * / 

EXITCRIT; 

} / * Global Data Sem obtained */ 

} / * Global data semaphore opened * / 

} / * Not first process */ 

/ 氺 

* If things are 〇 k. Register an exit list handler and if that works 

* increment the process count . 

*/ 

if ( ! rc) 

{ 

rc = D osExitLis t ( EXTL STADD - ORDER, 

(PFNEXITLIST) ShExitList) ; 

} 

if (rc) 

{ / * Error occurred- Clean Up */ 
if (HeapAl located. Attached) 

{ 

HhpReleaseHeap (hHeap, 

HhpGetPIDO ) ; 

} 

if ( GlobDataMtxCreated) 

{ 

DosCloseMutexSem(hmtxGlobalData) ; 

} 

if (Registered) 

{/ * Deregister */ 

PARM. DEREG smhDe regParm; 



smhDeregP am «111?1111 〇 : 七 :1 〇 11= SMH_ DEREGISTER; 
smhDeregParm pszSHName = pszHandlerName; 
SMHEntryPoint ( &smhDeregPam) ; 

} / * Deregi ster * / 
ulPr 〇 cessC 〇 unt-_; 
D 〇 sReleaseMutexSem(hmtxPr 〇 cCnt) ; 
DosCloseMutexSem(hmtxProcCnt) ; 
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} / * Error occur red- Clean Up */ 
else 
{ 

# ifdef MMRAS - PTRACE 

InitPTrace () 

# endif 

DosRel easeMutex Sem (hmtxProcCnt ) ; 

} 

}/ * Semaphore ok. In critical section */ 

/ * 

* The return codes expected are: 

* TRUE ( any non- zero) - init routine worked 

* FALSE (zero) -init routine failed 

氺 

* S 〇 we have t 〇 reverse the local rc before we pass it back • 
*/ 

return ( ! rc) ; 

}/ * End of SHInit * / 



□ 3-7 DLL □□□□□□□□□□□□□ 

DLL □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□，□□ DLL □□□□□□□□□□□□□□□□ ，□□□□□□□□ 
□□□□□□□□ 



# include 

# include 



r 〇 s2 Jrf 
r 〇 s2me • 



RC 


rc; 


/ 


* Error return code 


*/ 


HID 


hidSource; 


/ 


* Source handler ID 


*/ 


TIME- EVCB 


timeevcb; 


/ 


* Cue point event control block 


*/ 


HE VENT 


hevent; 


/ 


* time event handle 


*/ 


HSTREAM 


hstream; 


/ 


* Stream handle 


*/ 


HID 


hid; 


/ 


* Handler ID 


*/ 


PARM. EVENT 


parm. event; 


/ 


* Report event parameter block 


*/ 


lyiMTIME 


mmt imeCurrent ; 


/ 


* Current stream time 


*/ 


PSMHFN 


SMHEntryPoint ; 


/ 


* Pointer to SMH entry point 


*/ 



* Report an event 

* 



parm. event .ulFunction= SMH. REPORTEVENT; 



/ * Set function 
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parm. event .hid= hidSource; / * Source handler ID 

parm. event .hevent = hevent; / * Event handle 

parm. event .pevcbEvent = (PEVCB) &timeevcb; / * Pointer to Time EVCB 



timeevcb .ulType: EVENT- CUE- TIME; 

timeevcb .hstream: hstream; 

timeevcb .hid = hid; 

timeevcb .ulStatus = 0; 

timeevcb irimt imeStr earn: mmtime Current; 



/ * Set event type 
/ * Set stream handle 
/ * Set handler ID 
/ * No status 
/ * Set current time 



if (rc = SMHEntryPoint ( &parm. event) ) 

return (rc) ; / * Error ! */ 




D 3-8 DLL □□□□□□□□ 



3 7 6 □ □ 

DLL □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ SPCB □ □ SPCBHAND- GENSYNC □ SPCBHAND — NOSYNC □ 
CREATE □□□□□□□□□ SSM 〇 □□,□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□，□□□□□□□□□(□□□ 

□ □□□□□□□□□,□□□□ 〇 s^2DDDDDD,DD OS/2DDDDDD 

Timer DlevHelp □ 0 没 2 □ DosAsyncTimer □□□□□□□□□□ GetDOSVar 〇 

□ □□□□□□□ (GloballnfoSeg)j] 

□ 22 . 0 □□□□□□□□□□□□□□□ 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□□(□□□□□ 
□ □□□□□，□□□□□□□□□□□□□□□□ 






氺 



氺氺氺 



/ * Master 

/ * Synchronization- If we are the master stream, then report the 
/ * current time to the Sync/ Stream Manager so that 

/ * it can be distributed to any slave streams . 

y 氺氺 氺氺 氺氺氺 氺氺氺 氺氺氺 工; p 工 〇\ TIQNiS 氺氺 氺氺氺 氺氺氺 氺氺氺 

PARM. EVENT parmevent; 

SYNC- EVCB syncevcb; 



* parms for SMH. NOTIFY calls 

* Cuepoint event control block 



氺氺氺 



if (psib - > ulStatus & STREAM- MASTER- SYNC) 
parm. event nlFunction= SMH. REPORTEVENT; 
parm. event hid = psib - > Handler ID; 
parm- event hevent = hevent ; 
pam_ event pevcbEvent: (PEVCB) &syncevcb; 
syncevcb = EVENT- CUE- TIME; 



/ * Set function 
/ * Source handler ID 
/ * Event handle 
/ * Pointer to Sync EVCB 
/ * Set event type 



□ □ □ 
SHC- 

□ )□ 

□ Set- 

□ □ □ 
□ □ □ 

□ )；□ 
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syncevcb hstr earn = psib - > hStream; 
syncevcb hid= hid; 
syncevcb ^ilStatus = 0; 
syncevcb xrimtimeStream= inritimeCurrent; 

if ( rc = SMHEntryPoint ( &parm- event) ) 
return (rc) 



* Set stream handle 

* Set handler ID 

* No status 

* Set current time 



*/ 

*/ 

*/ 

*/ 



/ * Error ! */ 



/ * Slave */ 

/ * Synchronization- If we are the slave stream^then update the slave */ 



氺 

氺 

氺 

氺 



time and determine if this slave stream is 
too slow or too fast with respect to the master 
stream • 






END OF SPECIFICATIONS 






*/ 

*/ 

*/ 

*/ 

*/ 



if ( (pSTREAM) - > ulStateFlg & STREAM. SLAVE . SYNC) { 

(pSTREAM) - > SyncEvcb mmtimeSlave = mmtimeCurrStreamTime; 
if ( (pSTREAM) - > SyncEvcb ulStatus & SYNCPOLLING) { 

if (mmtimeCurrStreamTime 〉 （ pSTREAM) - > SyncEvcb jrmtimeMaster) 
/ * I need to slow my stream*/ 



if (mmtimeCurrStreamTimec (pSTREAM) - > SyncEvcb jrmtimeMaster) 
/ * I need to speed up my stream*/ 



□ 3-9 DLL □□□□□□ 

377 □□□□□□ 

□ □□□ DLL 

□ SSM □□□□□，□□□□□□□□□，□□□□□□□ SSMQ □□□□□□□□□ 

□ □，□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□ 
□ □□□□□，□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□ 

□ □□□ SSM □□□□□□, □□□□□□□□□□□□□□□□□□□□，□□ DLL 

□ □□□□□□，□□□□□□□□□□，□□□□□□□□□□□□ SSM □□□□□ 

□ □□□□□□□□□□□ 〇 □□□□□□□□□□□□□□□□□□□ 3-10 □ □ 
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# include < os2 h > 

# include < os2me h > 

# include < hhpheap h > 

# include < s hi h > 

PSIB psib; / * Stream Instance Block * / 

{ / * Start of FsshRead*/ 

RC rc = NO. ERROR; / * local return code */ 

char NeedBuf; / * local loop boolean */ 

LONG NumBytesIO; / * Number of bytes from mmio */ 

PARM. NOTIFY npget,npret; / * parms for SMH. NOTIFY calls */ 

SRCBUFTAB Sr cBufTab = { 0 } ; / * Source buffer table */ 

ULONG ul Stopped = DO. SLEEP; / * did we get stop disc or flush */ 

BOOL bAtEOS = FALSE; / * End of Stream indicator */ 

ULONG ul Post Count; / * Terrp to hold count */ 

/ * Before we start lets do some init stuff: */ 

npget .ulFunction= SMH. NOTIFY; 
npget .hid = psib - 〉 Handler ID; 
npget .hst ream: p sib _ > hStream; 
npget .ulGetNumEntries: lL; 
npget .ulRetNurrEntries = 〇 L; 
npget .pGetBufTab= &SrcBufTab; 
npget .pRetBuf Tab = NULL; 

npret .ulFunct ion = SMH- NOTIFY; 
npret .hid = psib - 〉 Handler ID; 
npret .hst ream: psib _ > hStream; 
npret .ulFlags = BUF RETURNFULL; 
npret .ulGetNurrEntries = 〇 L; 
npret .ulRetNurrEntries = lL; 
npret .pGetBuf Tab = NULL; 
npret .pRetBuf Tab = &SrcBufTab; 

/ * Wait until we get the ShcStart * / 

D 〇 sWaitEventSem(psib- 〉 hevSt 〇 p,SEM-INDEFINITE_WAIT); 

/ * We will loop forever getting an enpty buffer, calling the device to */ 

/ * fill up the buffer, sending it to the consumer . During each */ 

/ * iteration of the loop we will check the action flags for */ 

/ * asynchronous requests to do things . */ 
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if (psib- >ulActi 〇 nFlags & SIBACTFLG-KILL) 



{ / * Must have been a create error */ 

rc = lL; 

} / * Must have been a create error */ 
* Start the main loop */ 



while ( ! rc) 

{ / * while no severe error */ 

if (psib - > ulActionFlags) 
rc = CheckNSleep (psib) ; 

/ * 

* Get a buffer 
*/ 

NeedBuf = TRUE; 

while ( (NeedBuf ) & & ( ! rc) ) 

{ / * while we don t have a buffer */ 

/ * Clear the stop sem, so if after we call ssm to get a buffer if */ 

/ * it returns none avail then we won t miss a SSMBuffer Start */ 

/ * before we go to s leep . */ 

DosResetEventSem(psib - > hevStop, &ulPost Count) ; 

npget nlFlags = BUF- GETEMPTY; 

rc = SMHEntry Point ( & npget) ;/ * get a buffer */ 

if ( ! rc) 

{ 

NeedBuf = FALSE; 

/ * make sure attribute is 0 so we don t pass around a bad value */ 
SrcBufTab ialMessageParm= 〇 L; 

} 

else 

{/ * return code from smhnotify */ 
if ( rc == ERROR- BUFFER- NOT _ AVAILABLE) 

{/ * buffer not available */ 

/ * the smhnotify resets the num entries to 0 when none avail */ 
npget .ulGetNumEntries = lL; 

ulStopped= DO. SLEEP; 

rc= SleepNC heck (psib, &ul Stopped) ; 
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} / * buffer not available */ 

} / * return code from smhnotify */ 
} / 氺 while we dorf t h&ve a buffer 氺 / 



/ * We have a buffer or an error */ 
if ( ! rc) 

{ / * have a buffer- do the read */ 

NumBytes I 〇 = mmioRead ( (HMMI 〇 ） psib _ > ulAssocPl , 

(PCHAR) SrcBufTab pBuffer, 

(LONG) SrcBufTab ulLength) ; 

if (NumBytesIO = = - lL) 

{ / * an error * / 

SrcBufTab •alLength: 〇 L; 

/ * get the real error code */ 

rc = inmioGetLastError ( (HyMIO) psib - > ulAssocPl) ; 

rc= ShI 〇 Err 〇 r(psib, npret,rc) ; 

} / * an error * / 
else 

{ / * We have some data * / 

if (NurmBytesIO ! = (LONG) SrcBufTab .ulLength) 

{ / * End of stream*/ 

npret jjlFlagsl = BUF- EOS; 
bAtE 〇 S=TRUE; 

DosResetEventSem(psib - 〉 hevStop, &ulP 〇 st Count ) ; 
SrcBufTab .ulLength= NunnBytesIO; 

} / * End of stream*/ 

/ * Send the data to the stream manager */ 

rc = SMHEntryPoint ( &npret) ; 
if( ! rc) 

{ / * data sent ok * / 
if (bAtEOS) 

{ 

bAtEOS = FALSE; 

ulStopped= DO. SLEEP; 

rc = SleepNCheck (psib, &ulSt 〇 pped) ; 

} 

} / * data sent ok * / 

}/ * We have some data * / 



■ 112 ■ 




/ * Clear the EOS if it was set And attribute */ 
npret iilFlags = BUF. RETURNFUL L; 

SrcBufTab .ulMessagePam: 〇 L; 



□ □□□□□□□□□□□□□□□□□□□□□□ PDD □□□□□□□□□□□□ 

□ □□，□□□□□□□ SSM □□□□□□□□□□□ SSM □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□ 3-11 □ □ 

□ □□□□□□□□□□□□□□□□□□□ SMHEntryPoint □ DDCMDEn- 



} / * have a buffer- do the read*/ 

} / * while no severe error */ 

/ * We get here if an error has occurred or a kill has */ 

/ * been sent .In the case of the kill, reset the * / 

/ * return code to 0 (no error) and exit the thread . */ 

/ * Otherwise, report the error event and exit the */ 

/ * thread . * / 

if (psib- >ulActi 〇 nFlags & SIBACTFLG-KILL) 

{ 

rc = 〇 L; 

} 

else 

{ 

ReportEvent (psib, 

rc, / * Return code * / 

EVENT- ERROR, / 氺 event type 氺 / 

〇 L, / * user info * / 

NONRECOVERABLE . ERROR) ;/ * Severe Error * / 

} 

/ * Only set this flag when we no longer need access to the sib since */ 
/ * Destroy may get control and Free the sib .*/ 

psib - > ulActionFlags I = SIBACTFLG. THREAD. DEAD; 
return; 

} / * End of FsshRead * / 

□ 3-10 FSSHREAD .C 

3.8 PDD 
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□ 3-11 □□□□□□□□□□□□ 



tryPoint 〇 

3 J8 1 SMHEntryPOint 

□ □ SMHEntryPoint ，□□□□□□□□□□□□□□□□□ (SMH )〇 □□□ □ 
SSM[] □□□□□□，□□□□□ SSM □□，□□□□□□□□□，□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□ (idc)D 

AttachDD DevHelp □ □ □ □ □ □ 

3 2 2 DDCMDEntryPOint 

□ □□□□□□□□□□□ DDCMDEntryPoint □□ □ PDD □□□□□□□□□□ 

□ □□□□□□□ (DDCMD)Q □□，□□□□□□□□□□ PDD □□□□□□□，□□ 

□ □□□□□□□□□□□□□□ ATTACHDD DevHelp □□□□□ IDC □□□□□□ 

□ □□□□□□□□□□，□□□□□□□□□□□ DDCMD □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□ 



3 8 3 SHCEntryPoint 

□ □□ 3- □□□□□□□□□□□□□□□□□□□□□: SHCEntry Point 

□ SHDEntryPoint 口 

□ □□□□□□□□□□□ SSM □□□□□□□□□□□□□□□□□□□□□ 

□ □□□□ SHCEntryPoint □□□□□□□□□□ (SHC)：] □□□□□□□ SSM □ □ 

□ □□□□ IDC □□□□□□□□□ SpiCreateStream, SpiStartStream □ SpiStopStream 

□ □□□□□ (SPi)Q □ ,ssmq □□□□□□□□□□□□□ 

□ 3-12 □ SHCEntryPoint □□□□□ □ 



RC DDCMDEntryPoint (PDDCMDCOiyiiyiON pCommon) ;/ * PDD entry point from SH */ 
RC SHDEntryPoint (PSHD. COMyDN pCommon) ; / * SH entry point from PDD */ 

RC SHCEntryPoint (PSHC. COMyDN pCommon) ; / * SH entry point from SSM */ 

RC SMHEntryPoint (PSHC- COMyDN pCommon) ; / * SSM entry point from SH */ 

ULONG ( * ShcFuncs[] ) (PVOID pCornmon) = { / * SHC function jurrp table */ 

SHCAssociate, / * 0 */ 
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SHCClose, 

SHCCreate, 

SHCDestroy, 

SHCStart, 

SHCStop, 

SHCSeek, 

SHCEnableEvent , 

SHCDisableEvent, 

SHCEnableSync, 

SHCDisableSync, 

SHCGetTime, 

SHCGetProto col , 
SHCInstallP rotocol, 
SHGElnumer 己 t ^Protocol s , 
SHCNegot iat eResult 



/ * 1 */ 

/ * 2 */ 

/ * 3 */ 

/ * 4 */ 

/ * 5 */ 

/ * 6 */ 

/ * 7 */ 

/ * 8 */ 

/ * 9 */ 

/ * 10 */ 
/ * 11 */ 
/ * 12 */ 
/ * 13 */ 
/ * 14 */ 
/ * 15 */ 



USHORT MaxShcFuncs = sizeof (ShcFuncs)/ sizeof (USHORT) ; 












氺氺氺 / 



RC SHCEntryPoint (pCommon) 

PSHC- C 〇 My 〇 N pCommon; 

{ 

if (pCommon - > ulFunction > (ULONG) MaxShcFuncs) 
return (ERROR- INVALID - FUNCTION) ; 

/ * Check for valid function */ 

return ( ShcFuncs [pCommon - > ulFunction] (pCommon) ) ; 

} / * Call SHC message */ 

RC SHCStart (PPAPM. START pStart) 

{ 

PSTREAM pSTREAM; / * Ptr to current stream */ 

DDCMDREADWRITEDDCMDReadWrite; 

DDCMDCONTROL DDCMDCont r 〇 l ; 



ulRC 



rc; 



/ * Return code */ 



if ( rc = Get StreannEnt ry ( & pSTREAM, pStart - > hstream) ) 
return ( rc) ; 

Ent erCrit Sec ; / * Disable interrupts */ 

switch (pSTREAM - > ulStateFlg) { 
case STREAM. RUNNING: 
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/ * Get a full buffer for playback */ 

PanriNotify nlFunction= SMH. NOTIFY; 

PanriNotify hid= pSTREAM - > hid; 

PanriNotify hstream= pSTREAM - > hStream; 

PanriNotify nlGetNurrEntries = 1 ; 

PanriNotify ulRetNurrEntries = 0 ; 

PanriNotify pGetBufTab= & (pSTREAM - > BufTab aBufTab [usBufTablndex] ) ; 

PanriNotify pRetBufTab = NULL; 

PanriNotify nlFlags = BUF. GETFULL; 

SMHEntryPoint ( & PanriNotify) ; 

/ * Send full buffer to device (PDD) */ 

DDCMDReadWrite JiStream = ( * ppSTREAM) - > hStream; 

DDCMDReadWrite .ulFunction= DDCMD. V\/RITE; 

DDCMDReadWrite .pBuffer = pCurrentBufTab - > pBuffer; 

DDCMDReadWrite .ulBufferSize = pCurrentBufTab - > ulLength; 
rc = (* pSTREAM _ 〉 pDDCMDEntryP 〇 int) (&DDCMDReadWrite); 

/ * Start the device */ 

DDCMDControl nl Funct ion = DDCMD. CONTROL; 

DDCMDControl hStream = pSTREAM _ > hStream; 

DDCMDControl pP arm = NULL; 

DDCMDControl nlParmSize = NULL; 

DDCMDControl nlCmd= DDCMD. START; 

rc= ( * pSTREAM - > pDDCMDEntryPoint) (& DDCMDControl) ; 
break; 

} 

ExitCritSec; 

return (rc) ; 

□ 3-12 □□□□□□□□□□ SHCEntryPoint 

3 8 A SHDEntryPbint 

□ □□□□□□□□□a ? 〇〇 □□□□□□□□□□□□□□□□□□□□□ 
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(SHD)D □□□□□□□ SHDEntryPoint □□□□□□□□□□□□ PDD □□□□ □ 

□ □□□ PDDDDDD SHD_ REPORT -INTO □□□□□□，□□□□□□□□□□ 

□ □□□□□□□□□□ 

□ 3-13 □ SHDEntryPoint □ □ □ □ □ □ 



ULONG ( * ShdFuncs []) (PVOID pCommon) = {/ * SHD message jump table 

SHDReportlnt, / * 0 */ 

SHDRepo rtEvent / * 1 */ 



USHORT MaxShdFuncs = sizeof (ShdFuncs)/ sizeof (USHORT) ; 



氺 氺 






氺 氺 



氺氺氺 



*/ 



RC SHDEntryPoint (pCommon) 

PS HD. COMyDN pCommon; 

{ 

if (pCommon - >ulFunction> (ULONG) MaxShdFuncs) 

return (ERROR. INVZ\LID. FUNCTION) ;/ * Check for valid function */ 
return (ShdFuncs [pCommon - > ulFunction] (pCommon) ) ; 

} / * Call SHC message */ 






□ 3-13 □□□□□□□□□□ SHDEntryPoint 



3 8 5 □ □ □ □ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□ 

□ □□□□□□，□: 

■ □ □ PDD □ □ □ □ ; 

' □□□□□□□□□□□□□□□ 

3 851 PDD □ □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

DDCMD- STATUS □ □□□□□□□□□□□□□□□，□□□□□□□□□□□□□ 

□ PDD □□ DDCMD- STATUS □□□□□□□□□(□ 

□ □ DDCMD □□□□ PDD □□□□□□□□□□□□□□□□ 

□ □□□□)□□□□□□□□, PDD □□ SHDEntryPoint □ SHD_ REPORT. EVENT □ 

□ □□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□，□□ 
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SMM— REPORTEVENT □ SMHEntryPoint,[] □□□□ SSM □□□□□□□□□□□ 
□ ，SSM □□□□□□□□□，□□ 3-14[] □ □ 



RC SHDReportEvent (PSHD. REPORTEVENT pRptEvent) 



PSTREAM pSTREAM; 

ulRC rc; 



if ( rc = Get St reamEntry ( &pSTREAM, pRptEvent - > hStream) ) 
return(rc) ; 



pSTREAM - > ulStreamTime = pRptEvent - > ulStreamTime; 
/ * Update stream time */ 















氺 



PDD detected an event and notified the stream handler 



*/ 











while (pEVENT ! = NULL) { 

if (pEVENT - > hEvent = = pRptEvent - > hEvent) { 

RptEvent ^ilFunction= SMH- REPORTEVENT; 

RptEvent «hid= pSTREAM - > hid; 

RptEvent hevent = pEVENT - > hEvent; 

RptEvent pevcbEvent = & (pEVENT - > evcb) ; 

/ * call SSM to report event arrival */ 

Videos H pSMHEntryPoint ( & RptEvent) ; / * report it * / 

break; / 氺 proces s only one event and break out 氺 / 

} 

pEVENT = pEVENT - > pNext; 

} / * end while */ 
return (NO. ERROR) ; 



□ 3-14 □□□□□□□□□□□□□□ 

3S52 □□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□，□□□□□ PDDQ □ □ □ PDD □ 

□ □□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□,□□ SSMQ 3-15D 
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RC SHDReportEvent (PSHD. REPORTEVENT pRptEvent) 



PSTREAM pSTREAM; 

ulRC rc; 



if ( rc = Get St reamEntry ( &pSTREAM, pRptEvent - > hStream) ) 
return(rc) ; 



pSTREAM - > ulStreamTime = pRptEvent - > ulStreamTime; 
/ * Update stream time */ 



* Stream handler detected event and notified the SSM . */ 



while (pEVENT ! = NULL) { / * process all possible events */ 

if (pEVENT - > hEvent = = pRptEvent - > hEvent) { 

/ * Poll the current time to determine if the */ 

/ * event time is now . */ 



if (nnmtimeCurrTime > = pTimeEvcb - > rmtimeStream) { 
pTimeEvcb - > mmt imeSt ream = mmtimeCurr Time ; 
RptEvent .ulFunction= SMH_ REPORTEVENT; 

RptEvent .hid = pSTREAM - > hid; 

RptEvent .he vent = pEVENT - > hEvent; 

RptEvent .pevcbEvent = & (pEVENT - > evcb) ; 

/ * call the Syncy Stream Manager to report */ 

/ * event arrival . */ 

VideoSH .pSMHEnt ry Point (& RptEvent) ;/ * report it */ 



pEVENT = pEVENT - > pNext; 
} / * end while */ 



return (NO. ERROR) ; 



□ 3-15 □□□□□□□□□□□□□□ 





□ □□□□□□□□□□ MMTIME □□□□□□□□□，□□□□□□□□□ MM- 
TIMEQ □□□□□□□□□□ 

386 □□□□□ 






□□□,□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□ 



3 8 7 □ □ □ □ 



□ □□□□□□□□□□□□□□□ SSM,D □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□， PDD □□□□ SHDEntryPoint □□□□□□□□□□□ 
□，□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□，□□ SSMQ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□ 

□ □□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ 3-16 □ □□□□□□□□□□□□□□ 



RptEvent .ulFunction = SMH . REPORTEVENT; 
RptEvent .hid = pSTREAM - > hid; 

RptEvent .hevent = 0; 

RptEvent .pevcbEvent = (PEVCB) &evcb; 
evcb •alType = EVENT ■ 工 MPLICIT- TYPE,, 
evcb ulSubType = EVENT . ERROR; 
evcb ^ilFlags = 0; 
evcb jjlStatus = EVENT. ERROR; 
evcb hStr earn = pSTREAM - > h Stream; 

/ * call SSM to report event arrival 

VideoSH pSMHEntryPoint ( &Rairp pt Event) ; 



* must be 0 */ 

* SPI event */ 

氺 event type 氺 / 

* error code */ 

氺氺氺 / 



* report it ! */ 



□ 3-16 □□□□□□□□□□□□□□ 



3 8 8 □ □ 

□ □□□□□□□□□□□□□□□□□□，□□□□□□□ SPCB □□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□ 
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□ □□□□□□□□□□□ ，SSM □□□□□□□□□ DLL □□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□ SYNC- EVCB[] □□ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□ SYNC. EVCBQ 
SSM □□□□□□□□□□□□□ ，□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□ sync . evcb □□□□□□□□□ ssmdddd 

□ □□□SSM □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ 3-17 □□□□□□□□□□□□□□□□□□□□□ 



* If we are the master, then report the time so that the slaves 

* can adjust their time and be in sync with the master . 



氺氺氺 









*/ 



氺氺氺 , 



if ( (pSTREAM) - > ulStateFlg & STREAM. MASTER. SYNC) { 

(pSTREAM) - 〉 SyncEvcb«mmtimeMaster = nimtimeCurrStreamTime; 
RptEvent nlFunction= SMH. REPORTEVENT; 

RptEvent hid= (pSTREAM) - > hid; 

RptEvent hevent = 0; / * must be 0 for irrplicit events 

RptEvent pevcbEvent = (PEVCB) & ( (pSTREAM) - 〉 SyncEvcb) ; 
VideoSH pSMHEntryPoint ( &RptEvent) ;/ * report master time */ 



*/ 
*/ 

with respect to the master . */ 



* If we are the slave, then update slave time 

* and determine if this slave stream is too slow or too fast 



if ( (pSTREAM) - > ulStateFlg & STREAM. SLAVE. SYNC) { 

(pSTREAM) - > SyncEvcb mmtimeSlave = mmtimeCurrStreamTime; 
if ( (pSTREAM) - > SyncEvcb ulStatus & SYNCPOLLING) { 

if (mmtimeCurrStreamTime 〉 （ pSTREAM) - 〉 SyncEvcb itmtimeMaster) 
/ * I need to slow my stream*/ 



if (nmtimeCurrStreamTime < (pSTREAM) - 〉 SyncEvcb irimtimeMaster) 
/ * I need to speed up my stream */ 



□ 3-17 □□□□□□ 
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□ □:□□□□□□□□□□□□□□□□□，□□ 3. 2 



□ □□□□□□□□□□□□ iocti □□□□□□□□□□□□□□□□□□□□□ 

□ □ ioctiD □□□□□□□□□□□□□□□□□□□□□ 

IDC □□□ 09 2 ATTACHDD DevHelp □□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□ IDC □□□□□□ ，□□□□□□□□□□□□□□□□□□ 

3 9 1 IDCD □ 

□ □ □ IDC □□□□□□□□□□□□□□□□□□□： DDCMDEntryPoint 〇 
SHDEntryPoint[] DDCMDEntryPoint □□□□□□□□□□□□□ PDD □ □ □ □ , 
SHDEntryPoint □□□□□ PDD □□□□□□□□□□ 

□ □ PDD □□□□ 3- 18 〇 SSM □□ SMH □ □ 

□ □□□□□□□□□□□□□□□□□□□□□ DDCMD □□□□□□□□□□ 
PDDQ 

3 9 11 □ PDD □ □ 

□ DDCMD □□□□□□□ !□□□□□□□□□□□□□□□□□ PDD Q □ □ 

□ □□□□□□□□ 

□ □□□□□□□□□□□□ ? 〇〇 □□□□□□,□□□□□□□□□□□□□□ 

□ □ □ □ □ iocti □□□□,□□□□□□□□□□□□□□□□□□ 

(DDCMD) □ □ □ 

3912 □□□□□□□ 

SHDEntryPoint □□□□□□□□，□□□ \ TOOLKIT \ H □□□□ □ SHDD .H 

□ □□□ SHDD !!□□□□□□□□□□□□，□□□□□□□□# define □□□□ □ 

1 . SHD REPORT INT 

□ □□□□□□，□□□□□□□□ 

□ □□□□□□□□□□,□□□ ?〇〇□□□□□□□□□□□□□□□□□□□ 

□ □□□□,□□ PDD □□□□□□□□□□ 

2 . SHD REPORT EVENT 

□ □□□□□□□□□□ PDD PDDQ 



□ 

□ 

□ 

□ 

□ 

□ 
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□ 3-18 □□□□□□□□□□□□ 

□ 〇•!□□□□□□□□□□□□□□□□□□□□□□□□□□?〇〇□□□□,□□ 

□ □□□□□□□□ 〇 . 1 □□，□□□ SHD— REPORT — EVENT!] □□,□□□□□□□ 

□ □ ,PDD 〇 □ □ □ 

□ □ PDD □□□□□□□, □□□□，□□ PDD □□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□，□ PDD □□□□□□□□□□□□□ 

392 □□□□□ 

□ □□□□□□□□□□□□□，□□□□□□ DDCMD- CONTROL □□□□□ □ 

□ □□□，□□□□□□□□□□□□□□□ PDD □□□□□□□□□□□□□□□ 

□ PDDDDDDD 

□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□ DDCMD- SETUP □□□□□□□□□□□□□ 
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393 PDD □ 

□ DDCMD— SETUP □□□，□□□□□□□□□□□□ PDD[] PDD □□□□□ □ 

□ □ PDD □□□□□□□□□□□□□□□□□□, PDD □□□□□□□□ 0,□□ 

pddd □□□□□□□□□□□□□□□□□□ PDDDDDDD !□□□□□,□□ 

□ □□□□□□□□□□□□□□□ 30 □□□□□□□□□□□□，□□□□□ PDD 

□ □□□□ 〇 □□□□□□□□□□□□□□□□□ 30 □□□□□□□□ 

DDCMD— CONTROL □□□□□□ NOTIFY □□□，□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□ —— □□□□□□□□□□□□□□□□□□□□□□ 
□，□□□□□□□□□□□□□□□□□□□□□□□□□□□： 

1 DDCMD— CONTROL NOTIFY □□□□□□□□□□□□□□ PDD Q Q 

□ □□□□□□□□□□□□□□□□□□□□□ 

2. □□□□□□□□□□□□□□□□□□□□□□□□,□□□□ PDD □□□ 

□ □ □ 

□ □，□□□□□□□□□□□□□ DDCMD— CONTROL NOTIFY：] □□ PDD □ 

□ □□□□□，□□□□□□□□』〇〇□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□, PDD □ □ □ □ SHD— REPORT— EVENT[] □□,□□□□□□□□□ 

□ □□□□□□□□ 

□ □ □ □ □ ,PDDQ □□□□□□□□□□，□□□□□□□□□□□□□□，□□ 

□ □□□□□□ 5DDDD 

□ □ PDD □□□□□□□，□□□□ DDCMD_ CONTROL NOTIFY □，□□□ □ 

□ □□□□,□□□ ERROR— INVALID— REQUEST] □□□□□□□□□□□□□□ 

□ □ □ 

□ □ ： idc □□□□□□□□□ 〇 $/ 2DDDDDDDDDDD 



3 〇 D □□□□/□□□□□□ 



□ □/□□□□ (SSM)D □□□□□□： SSMDDD SYS □ SYS .DLL[] SSMDD .SYS 
□ SSM □□ 〇□□□□□□□□□□□□□□□□： 
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□ □ 

/ S:sss □□□□□□□□□□□□□□□□□ 1— 64Q □□□□□□ 8MB Q 

□ □，□□□□ 12; □□□□□ 8MB 6 〇 

/ P:ppp □□□□□□□□□□□□□□□□□ 1— 64Q □□□□□□ 8MB Q 

□ □，□□□□ 12; □□□□ 8MB 6 〇 

/ H:hhh □□□□□□□□□□ (KB)[j □□□□□ 16— 256[] □□□□ 64 〇 
/ Q:qqq □□(□□□□)□□□□□□□□□□□□□ 2— 1024; □□□□ 64 〇 
/ E:eee □□ (□□□)□□□□□□□□□□□□□ 1 — 1 〇 24 〇 □□□□□□ 
8MB □□□，□□□□ 32; □□□□□ 8MB 
20 □ 

□ DEVICE = SSMDD SYS □□□□ □ CONFIG SYS □□□□□□□□ 0□□ 

□ □□□□□ 

□ □/□□□□□□□: 

■□□□□□ 64 〇 

■ □□□□□□□□□□□□ 64Q 

■ □□□□□□□□□□ 64Q 

■ □□□□□□□□□/□□□□□□□□ l 〇 24 □ □ □ □ 
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□ 4n v 〇 □ □ 



□ □□□□□□□□□□□□□□ (10 Pr 〇 c)[| □□□□□ \ TOOLKIT \ 

samples \ mm □□□□□□□ P 〇 DDDDDD ： 

1. Case. Converter 

□ □□□□□□□□□ ^ 〇 DD (□□□□□□□□□□)□□□□□□□□□□ 

□ \ TOOLKIT \ SAMPLES \ CASECONV □□□ □ 

2. M Motion 

□□□□□□□□□□□□□□□□□□ 

M — Motion □ □□□□□□□□□□□□□□□□□□□□□ \ TOOLKIT \ SAMPLES 

\ MM \ MMIOPROC □ □ □ □ 

* 

3. Ultimotion 

□□□□□□□□□□□□□□□□□□□ 

ULIOT □ □ □ CODEC □□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □!/ 〇 □□□□□ \ TOOLKIT \ SAMPLES \ MM \ ULTIMOIO □□□ □ 

□ □□□□□ m _ Motion PODDDDDDDDD, □□□□□□□□□□□□□ 

□ □□□□□□□□ Ultimotion P 〇〇 DDDD ,□□□□□□□□□□□□ CODEC 〇 

□ □ 



4.i r 〇 □ □ □ □ 

OS/ 2 □ □ □ □ MMIO □□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□ □□□□ MMIO □□ ， MMIO[] □□□ P 0 □□ (IOProc)D □ 

□ □□□□□□□□□□□□ 4-1 □□□ 0S/2DDDDDDDDDDDDD 

411 □ □ □ □ 

IOProc □□□□□□□□□□□□□□□□□ MMIO □□□□□□□ MMIO □ □ 

□ IOProc □□□□ MMIO □□□□□□□□□□， MMIO □□□□□□□□□□□□ 

□ □□□□□□□□□□□□□ IOProc □□□□□□□, i^ODDDDDDDD mmio 

□□□□□□□□□□□□□□□□□□ 

MMIO □□□□□□□□□，□□□□□□□□□□ 

1 - □ □ □ □ □ 

□ □□ MMIO □□□□□□□□□□□□□□□□□□□，□□ mmioOpen □□ □ 

□ □ □ □ □ MMIOQ □□□ PODDDDDD MMIOM- OPEN □□，□□□□□□□□ 
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□ □□□□□□□□□□□□□□□□□□□□□□□□ MMIO □□□□□□□□□ 

□ □□□□□ !/〇□□，□□□□□ !/〇□□□□□□□ 

4 .1 2 □" ]/ O □ □ □ □ (FOURCC)〃[] 4 .1 .3 y O □ □ □ □ 〃 口 



□ 4^1 □□□!/ 0 □□ 



2 . □□□□□□ 

□ □□□□□□□ mmioSendMessage □□□□□□□□□□□ ^ 〇 DDDDDD 

□ □□□□□□□□□□□□□□□ !" 〇 □□(□□□□□□□□□ MMIO □ □ □ □ 

□ )□ \ TOOLKIT \ H □□□□□ MMIOOS 2 .H □□□□□ MMIO— USER □□□ □ 

□ □□□□□□□□ mmioSendMessage □□□□□□□□□□□□□□□□□□ 
MMIOOS 2. HDDDDDD MMIOM _ USER □ □ 

412 r 〇 □ □ □ □ □ (FOURCC) 

FOURCC □□□ 32 1[] 4[] ASCII □□□□□□□□□□□(□□ 

□ □□□□)□□□ ^ODDDDDDDDDDDDDDDDDDD i 〇 Pr 〇 c □ □ □ □ 
FOURCC □□□□□□□ FOURCC □□ ID □□□,□□□□□□□□□□□□□□ 
(NLS)D □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□ FOURCC, □□□□□□□□ 
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□ □:□□□□□□□□□□□，□□□ mmioIdentifyFile □□□□ □ 

4 J. 3 r 〇 □ □ □ □ 

□ □ □ MMIO □□□□□□□□ IOProc □□□□□□ !/ 〇 □□：□□□□□□□ 

□ □□□□□□ IOProc □□□□□□□，□□□□□□□□ MMIO □□□□□，□□□ 

□ IOProc □□□□□□□□□□□，□□□□□□□□□□□□□ 

□ □□□□□□□□ ^OQDDD, □□□□□□□ IOProc □ MMIO^ IOPROC. 
FILEFORMAT □ □ □ □ □ IOProcs □ MMIO IOPROC- STORAGE SYSTEM □ □ 
MMFORMATINFO □ □ □ □ ullOProc Type □□□□□□□□□□□□,□□□□□ 

PODDD NLSDDDDP 〇 DDDDDDDDD,DDDD RCDDDDD dll □ □ 

IOProc □□□□ GETFORMATINFO □ GETFORMATNAME □□□□□□□□□□ 

4131 □ □ □ □ r 〇 □ □ 

□ □□□ IOProc □□□□□□□ MMIO □□□□(□□ RIFF □□□□□□)，□□ 

□ □□□□□□□□□□□□□□□□□□□□□□，□□□□□□□ IOProc □ □ □ □ 

MMIOM— GETFORMATINFO □ MMIO □ □□□□□□□□□□□□□□□ 

□ □ IOProc[] □□□□□ MMIOM. GETFORMATINFO MMIO □□ IOProc 

□ □□□□ IOProc □□□□□□□ MMFORMATINFO □□ ，FOURCC □□ □ 

□ □，□□□□□□□□□□□□□□□，□□□□ MMIO □□□□□□□□□□ 

□ □□□□□□□□□□□□□□ IOProcD □□，□ 4-2 □□□□□□□□□□□□□ 

□ IOProc □□□□□□□□ IOProc 〇 



default : 




Declare Local Variables . 



*/ 

PMMFILES TATUS pVidln f 〇 ; 

LONG IRC; 




* Check for valid MMIOINFO block . 
if ( ! pmmioinfo) 



return (MMIO. ERROR) ; 




Set up our working variable MMFILESTATUS • 




pVidInf 〇 = (PMMFILESTATUS) pmmioinfo- >pExtraInf 〇 Struct; 
if (pVidlnfo ! = NULL & & pVidlnfo- > hrtimioSS) 
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IRC = mmioSendMessage (pVidlnfo- > hmmioSS^ 



usMsg, 
lParaml , 
lParam2) ; 

if ( ! IRC) 

prrmioinf o- > ulErrorRet = rnmioGetLastError (pVidlnfo- > hrtimioSS) ; 
return (IRC); 

} 

else 

{ 

if ( prrmioinf o ! = NULL) 

pmmioinfo- > ulErrorRet = miOERR. UNSUPPORTED. MESSAGE; 
return (MMIOERR. UNSUPPORTED. MESSAGE) ; 




end case of Default 



*/ 



□ 4^2 □□□□□□ (MMOTPROC .〇 

□ □□□□□□□□□DO i 〇 Pr 〇 c ,〇 □□□□□□□□□□□： 

■ MMIOM OPEN 

■ MMIOM READ 

■ MMIOM WRITE 

■ MMIOM SEEK 

■ MMIOM CLOSE 

■ MMIOM GETHEADER 

■ MMIOM SETHEADER 

■ MMIOM QUERYHEADER 

4132 □ □ □ □ FOOD 

□ □ □ □ IOProc □□□□□□□□□□□□□□□□□□□□□□□, DOS □ 
MEM □ IOProcs □□□□□□ : 

■ MMIOM OPEN 

■ MMIOM READ 

■ MMIOM WRITE 

■ MMIOM SEEK 

■ MMIOM CLOSE 

■ MMIOM GETFORMATNAME 

■ MMIOM GETFORMATINFO 

■ MMIOM IDENTIFYFILE 

□ □□□□□□ IOProc IOProc □ □ 
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□ □□ M- Motion, □□□□□□□□□□□ M-Motion IOProc[] P 0 口 

□ □□□□□□□□□□□□□□□□□□□□，□□□□□□□□□(□□ 

□ □ □ m □ DMiDinn 4-3 □□□□□□□□ 



MMIO 

□ □ □ □ □ 
IOProc □ □ 

□ □ □ 
□ □ □ □ □ 
□ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 



□ □□□□□□□□ IOProc □□ □ 

□ □：□□□ OS/2DDDDD RIFF □ □ □ □ (CF)IOProc □ □ □ MMIOM- I- 
DENTIFYFILE, MMIOM GETFORMATINFO □ MMIOM GETFORMATNAMEQ □ 

□ □□ IOProc □□□□□□□□ MMIO □□，□□□ (BND)IOProc □□□□□□□VO 

□ □□□□□ IOProc □□□□□□□□□□□□ IOPrcx^D 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

2 

4 



□ 

□ 

□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ 
□ 

□ □ 
□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

o 



□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

0 , 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 
□ 
□ 
□ 
□ 
□ 
□ 

□ □ 
□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ □ 
□ □ 
□ □ 
□ 

□ 

□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 





□ 

□ □ 

□ □ 

□ □ 
， □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 
□ 

□ CD 

□ pro 

□ o 



□ 

□ 

□ 

□ 



□ 

□ □ 
□ □ 
□ 

□ 

□ □ 
□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

D □ 

D □ 

M □ 

□ □ 
□ □ 

□□ □ 

□ □□ 
□ □ 
(□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
m □ 
□ □ 



□ n 

□ n 

□ n 

□ n 

□ ， 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 



□ 

□ n 

□ n 

□ n 

□ n 
， n 

□ n 

□ n 

□ n 

□ n 

□ n 

□ n 

□ n 

CD n 
ro n 
p 



o 



n 



I n 
□ □ 






□ I 

□ □ 

□ 

□ ] □ 

_ _ 

e _ _ - n 
Ir 口 
tu □ 
^ □ 
u 
r 

St 



□ 



□ 

□ 



□ 

□ 



□ 



n 

tio l □ 

•ip n □ 



a □ 



□ 



□ 



□ 

□ 

□ 

□ 

3 

4 - 

□ 



e: 

d □ 

( □ ] 
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□ □□□□□□□□，□□□□□□□□□□ 21 □ YUV □□，□□□□□ IOProc □ □ 

□ □□□□□□□□ 24 □ RGB：] IOProc □□□□□□□□□□□□□ YUV □□ □ 
RGBD 

□ □□□□□□□□□，□□□□□□□ I 〇 Pr 〇 c □□□，□□□□□□□□□□□□□ 

□ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□ 4-1 □□□□□□□□□□□□ 

□ □□□□□□□ 



□ 4^1 □□□□□□ 



□ □ 


□ 


□ □ 


□ □ 


MMAUDIO 


PCM 11 .025, 22 .05, 33 .1 kHz 


□ □ 


MMIMAGE 


OS^2 1.3Q □ (24 □ RGB,1,4,8Q □ □ □ ) 


MIDI 


MMMIDI 


□ □ 〇 □ 1 


□ □ 


MMMOVIE 


□ □□□□□□□ 


□ □ 


MMYIDEO 


16, 24 □ RGB, 4, 8 □ □ □ □ 



□ □：□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□ 



4 2 1 MMFORMATINFO □ □ □ □ 



□ □ MMIO □□□□□□□□□□□□ MMFORMATINFO □□□□□ mmioOpen 

□ □ □ □ □ MMIOINFO □ □ □ □ ulTranslate □ □ □ □ □ MMIO TRANSLATE- 
HEADER □ MMIO - TRANSLATED ATA □□□□□□□□□□□□□□□□□□□ 

□ MMIOOS 2. HQ □ 

□ □□□□□ 4-4 □□□ MMFORMATINFO □□ □ 



typedef struct - MMFORMATINFO { 



rnmformatinfo 



*/ 



ULONG 

FOURCC 

ULONG 

ULONG 

ULONG 



ULONG 

ULONG 



ulStructLen; 
fccIOProc; 
ul I OProcType ; 
ulMediaType; 
ulFlags 



* Length of this structure 

* IOProc identifier 

* Type of IOProc 

* Media type 

* IOProc capability flags 



szDefaultFormatExt [ sizeof (FOURCC) + 1 ] ; */ 

/ * Default extension 4 + null 
ulCodePage; / * Code page 

ulLanguage; / * Language 



*/ 
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LONG INameLength; / * Length of identifier string */ 

} MMFORMATINFO; 



□ 4-4 MMFORMATINFO □ □ □ □ 



4.3 r 〇 □□□□□ □ 



□ 4-5 □□□□□□□ 



LONGAPIENTRY IOProc. Entry ( PVOID 


prrmioStr, 


USHORT 


usMessage, 


LONG 


lParaml A 


LONG 


lParam2) 



4-5 !/〇□□□□□□ 



□ □□□□□□□□ 4-2 □□ 

□ 4^2 □ r 〇 □□□□□□□□□□□ 



□ □ 



PVOID pmmioStr 
USHORT usMsg 

LONG lParaml 
LONG lParam2 



□ □□□□□□□□□□□ MMIOINFO □□□□□□□□□□□ 

□ □□□□□ !/〇□□□□□□□□(□□□□□□□□□□□□□□□□ 

□ □ MMIOM- USERQ) 

nnnnnnnnnn 门 nn(nnnnnnnnnn) 



□ □:□□□□□□□□□□□ 〖◦□□□□□□□□El usMsg □□□□□,□ □ 
□ □□□□□□□□□□ usMsg, □ P 〇 □ □ □ □ □ MMIOERR UNSUPPORTED 
MESSAGED 



4.4 □ □ □ □ □ 



□ 4-6 □□□□ M- Motion P O □□ (MMOTTK .DLL)D □□□□□□□□□□□ 
□ □□□ !/〇□□□□□□□□□□□□□□□□□□ 

4 4 1 MMIOM. OPEN 

□ □ IOProc □□□□□□□ MMIOM _ OPEN □□，□□□□□□□□□□□□□ 

□ □□□□□□□□ lOProc mmioOpen □□□□□□□□□ 

□ □□□□□□□□□□□□□ FOURCC □ □ □ □ □ IOProcD 

□ MMIO □□□□□□□ MMIOM— OPEN □□□，□□□□□ IOProcd □□□ □ 

□ □ ： 
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□ 4-6 M-Motion !/0□□□□□□□ 

■ □□□□ IOProc □□ pmmioinfo □□□ fccChildlOProc □□□□□□□□ 
mmioOpen[] □□□□□□□ MMIO — NOIDENTIFYO □ □ 

■ MMIOINFO □□□ lLogicalHlePos □□□ 0□，□□□□□□，□□□□□□□□ 

□ □□□□□□□，□□□ mmioSeek[] □□□□□□□ lLogicalFilePos 〇 

■ □ □ □ □ IOProc □□□□□□□□□ MMICK TRANSLATEDATA □ MMIO — 
TRANSLATEHEADER 

□ □□□□□□ (□□□□□□□□ 〇 ^2QDD □□□ 00(0^ 2 Multimedia Pro- 
gramming Reference) □ 

□ □□□□ IOProcO □□ IOProc □□□□□□□□□□□□□□□□□□□□ 

□ □ 

□ □ OPEN □□，□□□□□□□□□□□ mmioGetHeaderlnfo □□□□□□□□ 

□ □ □ □ □ 

□ 4-7 □□□□□□□□□□ IOProc □□ MMIOM — OPEN □□□ MMIOM — OPEN 

□ □□□□□ mmioOpen □□□□□□□□□□ MMIO □□□□□ IOProc □□□□ □ 

□ □□□□□□□□□□□，□□□□□ IOProc □□□□ hmmio □□ (HI )□□□□ □ 

□ □ □ □ □ IOProc □ MMIOINFO Q aullnfo [!] 〇 □□□□□□□□□□ □□□ 
mmioOpen □□□,□□□□□□□□□□□□□□□ (H2 )〇 □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□ H2,DDDDD IOProc □□□□□□□□ 
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□ □ IOProcQ □ MMIOQ Q □ H1Q 

□ 4-7 □□□□□□□□ M- Motion IOProc □□□□□ MMIOM— OPEN □□□ □ 



case MMIOM. OPEN: 



* Declare local variables 

PMMFILESTATUS pVidlnfo; / * pointer to an M- Motion file */ 

/ * status structure that we will */ 

/ * use for this file instance */ 



MMIMAGEHEADER 


MMImgHdr; 




ULONG 


u IRequiredFileLengt h; 




ULONG 


u lActualFi leLength; 




ULONG 


ulWidth; 




ULONG 


ulHeight; 




PBYTE 


lpYUVBuf; 




ULONG 


ulRowCount; 




ULONG 


u lRGBBytes PerLine ; 




ULONG 


u 1 YUVBytes PerLine ; 




LONG 


rc; 




HMMIO 


hmmioSS; 




PBYTE 


IpRGBBufPtr; 




FOURCC 


f ccStorage System; / * 


SS 艾 〇 P roc FOURCC 


MMI 〇 INF 〇 


mmioinfoSS; / * 


1 / 0 info block for SS ref 



PSZ pszFileName = (CHAR * ) lParaml ; / * get the filename from 

/ * parameter 



*/ 

*/ 

*/ 

*/ 



* Check for valid MMIOINFO block . 



if ( ! pmmioinfo) 

return (MMIO. ERROR) ; 

* If flags show read and write then send back an error • We 

* only support reading 〇 r writing but not both at the same 

* time on the same file . 

if ( (pmmioinfo 〉 ulFlags & 剛工〇 - READWRITE) & & 

( (pmmioinfo > ulTranslate & MMI 〇 _ TRANSLATE DATA) II 
(pmmioinfo > ulTranslate & MMI 〇 _ TRANSLATE HEADER) ) ) 
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return (MMIO. ERROR) ; 



* Determine the storage systert/ child IOProc that actually 

* obtains the data for us . The M- Motion data may be contained 

* in a memory (RAM) file, as a corrponent in a database or 

* library (aCorrpound file) , or as a stand-alone disk file . 

氺 

* While the application uses this M-Motion IOProc to obtain 

* untranslated (M- Motion) or translated (bit map) data, 

*the IOProc must obtain it" s data from something that 

* reads and writes to a storage media . The exact storage 

* media is immaterial- so long as the read and write 

* operations generate data that LOOKS like it is part 

* of a standard file • 

if ( ! pmmioinfo- > fccChildlOProc) 

{ 

/ * Need to determine SS if create from pmmioinfo and filename . */ 
if (pmmioinfo >ulFlags & MMI 〇 _ CREATE) 

{ 

if (irmi 〇 DetemineSSI 〇 Pr 〇 c( pszFileName, 

pmmioinfo, 

& f ccStorage System, 

NULL ) ) 

{ 

fccStorageSystem= FOURCC. DOS; 

} 

} 

else 

{ 

if (nnmioIdentifyStorageSystem( pszFileName, 

pmmioinfo, 

& fccStorageSystem ) ) 

{ 

return (MMIO. ERROR) ; 

} 

} 

if ( ! fccStorageSystem) 

{ 

return (MMIO. ERROR) ; 
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else 



pmmioinfo- > fccChildlOProc = fccStorageSystem; 

} 

} / * end storage system identification block */ 

* Direct the open to the specific storage system necessary 
******************************， 

memset ( &mmi 〇 inf 〇 SS/ \ (X , sizeof (MMIOINFO) ) ; 
memmove ( &nrnioinfoSS A pmmioinfo, sizeof (MMIOINFO) ) ; 
mmioinfoSS .plOProc = NULL; 

mmioinfoSS .fccIOProc = prtinioinfo- > fccChildlOProc; 
mmioinfoSS .ulFlags I = MMIO. NOIDENTIFY; 

* Try to open the file . Add the NO IDENTIFY flag to 

* ENSURE THAT WE DON" T LOOP RECURSIVELY ! ! ! 
******************************， 

hmmioSS = rnmioOpen (pszFileName, 

& mmioinfoSS, 
mmioinfoSS ulFlags) ; 

* Check if a DELETE was requested- mmioQpen returns a 1 , 

* so we much check this separately 
******************************， 

if (pmmioinfo- > ulFlags & MMIO. DELETE) 



/ * was the delete successful ? 
if (! hmmioSS) 



*/ 



pmmioinfo- >ulErr 〇 rRet = My[I 〇 ERR- DELETE - FAILED; 
return ( 應工〇 _ ERROR) ; 

} 

else 

{ 

return (MMIO. SUCCESS); 

} 

} 

* Check the return code from the open call for an error . 
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* If not delete, then the open should have worked • 
******************************， 

if ( ! hrtimioSS) 

return (MMIO. ERROR) ; 

* Allocate memory for one M- Motion FileStatus structures 
******************************， 

D 〇 sA11 〇 cMqtl ( (PPVOID) fepYidlnfo, 

sizeof (MMFILESTATUS) , 
fALLOC) ; 

* Ensure the allocate was successful . If not, then 
close the file and return open as unsucessful . . . 



氺 



******************************， 
if ( ! pVidlnfo) 

{ 

mmioClose (hrtimioSS, 0) ; 
return (MMIO. ERROR) ; 

} 

pVidlnfo- > hmmioSS = hmrdoSS; 

* iStore pointer t 〇 our lyUMFILESTATUiS structure in 

* pExtralnfoStruct field that is provided for our use . 
******************************， 

pmmioinfo- > pExtralnfoStruct = (PVOID) pVidlnfo; 

* Set the fields of the FileStatus structure that the 

* IOProc is responsible for . 

******************************， 
InitFileStruct (pVidlnfo) ; 

* If this is a read, we need to check that is a M- Mot ion 

* file and perhaps get the data . 
******************************， 

if (pmmioinfo- > ulFlags & My[IO- READ) 



* First we must get some basic information from the file 

* Read in data t 〇 fill up the MyDTIONHEADER structure • 



氺 



If the read is unsuccessful, this is not a M- Motion file 
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and we should return a failure on the open 






if (sizeof (MMOTIONHEADER) 



mmioRead (pVidlnfo- 〉 hmmioSS, 



(PVOID) &pVidI nfo- 〉 mm 〇 t Header , 
(ULONG) sizeof (mOTIONHEADER) ) ) 



mmioClose (pVidlnfo- >hrtimioSS f 0) ; 
DosFreeMem ( (PVOID) pVidlnfo) ; 
return (MMIO. ERROR) ; 



/ * Ensure this IS an M-Motion file header before we continue */ 
if (strcrrp (pVidlnfo- >inmotHeader mmlD, ，， YUVl2C r， ) ) 



mmioClose (pVidlnfo- >hrtimioSS, 0) ; 
DosFreeMem ( (PVOID) pVidlnfo) ; 
return (MMIO. ERROR) ; 



* Set up width and height of image . 

ul Width = (ULONG) pVidlnfo- > mmotHeader inmXlen; 
ulHeight= (ULONG) pVidlnfo- >mmotHeader mmYlen; 

/ * Calculate what the length of the file SHOULD be based on the */ 
/ * header contents */ 

ulRequiredFileLength= ( ( (ulWidth > > 2) * 6) * ulHeight) + 

sizeof (MyDTIQNHEADER); 

/ * Query what the ACTUAL length of the file is, */ 

/ * then move back to Just after the header . 
ulActualFileLength= (ULONG) mmioSeek (pVidlnfo- > hrrmioSS, 

0, SEEK. END) ; 

mmioSeek (pVidlnfo >hmmi 〇 SS, sizeof (MyDTIONHEADER) , SEEK- SET) ,• 

/ * If these dori t match, then it isn t a VALID M-Motion file */ 
/ * -regardless of what the header says . */ 

if (ulRequiredFi leLength ! = ulActualFileLength) 



mmioClose (pVidlnfo- > hrrmioSS^ 0) ; 
DosFreeMem ((PVOID) pVidlnfo); 
return (MMIO. ERROR) ; 
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* If the app intends to read in translation mode, we must 

* allocate and set-up the buffer that will contain the RGB data . 

氺 

* We must also read in the data to insure that the first 

* read, seek, or get-header operation will have data 

* to use . This is ONLY NECESSARY FOR TRANSLATED MODE 

* operations, since we must process read" writes pretending 

* the image is stored from the bottom- up . 

氺 

* Fill out the MMIMAGEHEADER structure . 

MV [工 mgHdr .ulHeaderLength = sizeof (MMIMAGEHEADER) ; 

MyilmgHdr .ulContentType = 剛工〇- IMAGE- PHOTO; 

MV [工 mgHdr .ulMediaType = 剛工〇_ MED 工 AT YPE_ IMAGE; 

My [工 mgHdr itimXDIBHeader BMPInf〇Header2 .cbFix = 
sizeof (BITMAPINF〇HEADER2) ,• 

My [工 mgHdr itiriXDIBHeader BMPInf〇Header2 .ex = ulWidth; 

MyUmgHdr inmXDIBHeader BMPInf〇Header2 .cy = ulHeight; 

My [工 mgHdr jnmXDIBHeader BMPInf〇Header2 .cPlanes =1; 

My [工 mgHdr BMPInf〇Header2 .cBitCount = 24; 

MyUmgHdr BMPInf〇Header2 .ulConpression = 



BCA_ UNCOMP; 

MyUmgHdr jnmXDIBHeader BMPInf 〇 Header2 .cblmage = 

ulWidth * ulHeight * 3; 

MyilmgHdr itiriXDIBHeader BMPInf 〇 Header2 .cxResolution = 〇 L; 

MyilmgHdr jmXDIBHeader BMPInf 〇 Header2 .cyResolution = 〇 L; 

MyUmgHdr inmXDIBHeader BMPInf 〇 Header2 .cclrUsed = 〇 L; 

My[ImgHdr BMPInf 〇 Header2 .cclrlrrportant = 〇 L; 

MyUmgHdr BMPInf 〇 Header2 .usUnits = 〇 L; 

MyilmgHdr ! 〇成 0 工別 6& 〇 161 BMPInf 〇 Header2 .usReserved = 〇 L; 



MyilmgHdr itiriXDIBHeader BMPInf 〇 Header2 .usRecording = 

BRA. BOTTOMUP; 

MyilmgHdr imiXDIBHeader BMPInf 〇 Header2 .usRendering = 

BRH - NOT HALFTONED ; 

MyUmgHdr inmXDIBHeader BMPInf 〇 Header2 .cSizel = 〇 L; 

MyUmgHdr BMPInf 〇 Header2 .cSize2 = 〇 L; 

lyiMImgtldr ByiPInf 〇 tieader2 .ulColorEn coding = 〇 L; 
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MyilmgHdr itimXDIBHeader BMPInf 〇 Header2 .ulldentifier = 〇 L; 

* Copy the image header into private area for later use . 

* This will be returned on a rrimio Get Header () call 
******************************， 

pVidlnfo- > mmlmgHdr = MMImgHdr; 

* YUV Byte^ Line are = 11/2 times the number of pels 
******************************， 

ulYUVBytesPerLine = ulWidth + (ulWidth > > 1); 

* RGB Byte^ Line are = 2 * YUV byte^ line 
******************************， 

ul RGBBytesP erLine = ( ul YUVByte sPerLine < < 1) ; 

* Determine total bytes in image 

******************************， 
pVidlnfo- > ulRGBTotal Bytes = ulWidth * ul Height * 3 ; 

* M-Motion images are always on 4-pel boundaries, which also 

* makes them on 4- bytS LONG boundaries, which is used for 

* bit maps . Therefore^ there are no extra pad bytes necessary . 
******************************， 

pVidlnfo- > ullmgPaddedBytesPerLine = ulWidth * 3; 
pVidlnfo > ullmgTotalBytes = pVidlnfo- 〉 ulRGBTotalBytes; 

* For translated data READ mode f we must allocate a buffer, 

* get the YUV data from the file, and load the RGB buffer . 

* Place format- specific code here to load the image into the 

* buffer . The code below is M-Motion format specific . 
******************************， 

if (pmmi 〇 info>ulTrani5late TRANSIATEDATA) 



* Get space for full image buf fer . 

* This will be retained until the file is closed . 

if (DosAllocMem ( (PPVOID) & (pVidlnfo- > IpRGBBuf ) , 
pVidlnfo- > ulRGBTotalBytes, 
f ALLOC) ) 
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mmioClose (pVidlnfo- > hrrimioSS, 0) ; 
DosFreeMem ( (PVOID) pVidlnfo) ; 
return (MMIO. ERROR) ; 



* Get terrporary space for one line YUV buffer . 

if (DosAllocMem ( (PPVOID) &lpYUVBuf, 
ul YUVBytesP erLine r 
f ALLOC) ) 

{ 

nrnioClose (pVidlnfo- >hrtirrdoSS f 0) ; 

DosFreeMem ( (PVOID) pVidlnfo) ; 
return (MMIO. ERROR) ; 

} 

* Initialize the beginning buffer position . 
IpRGBBufPtr = pVidlnfo- > IpRGBBuf; 

* Read in YUV data one line at a time, converting 

* from YUV to RGB, then placing in the image buffer . 

for ( ulRowCount = 0 ; 

ulRowCount < ulHeight; 
ulRowCount + + ) 



* Read in one line . 

rc = mmioRead (pVidlnfo- > hrtimioSS, 

(PVOID) lpYUVBuf, 

(ULONG) ulYUVBytesPerLine) ; 

* Convert one line at a time . 

Con vert OneLi neYUVtoRGB (lpYUVBuf, 

IpRGBBufPtr, 
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ulYUVBytesPerLine) ; 

* Make sure buffer ptr is correct for the next convert . 
****************************， 
IpRGBBufPtr + = (LONG) ulRGBBytesPerLine; 

} / * end of FOR loop to read YUV data */ 

DosFreeMem (lpYUVBuf); 



* This changes from Motion’ s t 〇 p~ down 

* Piyf S bottom- up bit map form . 



. to 0^ 2 



氺 氺氺氺 



氺氺氺 






ImgBufferFlip (pVidlnfo- 〉 IpRGBBuf, 

pVidlnfo- > ullmgPaddedBytesPerLine, 



ul Height) ; 



氺 氺氺氺 






* RGB buffer now full, set position pointers to the 

* beginning of the buffer . 

******************************， 
pVidlnfo- > IlmgBytePos = 0; 

} / * end IF TRANSLATED block */ 

} / * end IF READ block */ 
return (MMIO. SUCCESS) ; 

} / * end case of MMIOM. OPEN */ 



□ Arl MMIOM - OPEN □ □ (MMOTPROC.C) 

4 4 2 MMIOM. READ G MMIOM. WRITE 

MMIOM— READ □□□□□□□□□□□□□ ;MMIOM— WRITE □□□□□□ □ 

□ □□□□□□□□□□□□ I 〇 Pr 〇 c □□□□□□□□，□□□□□□□□□□□□□ 

□ □□□□□□□□ P 〇， mm i 〇 Read □ mmioWrite □□ lBufOffset □ HDiskOffset □□ □ 
IOProc □□□□□□□□□□□ IOProc □□□□□□，□□ aullnfo □□□□□□□□, 
pExtralnfoStruct □□□□□ IOProc □□□□□□□□□□ IOProc □□□□□□□□□ 

□ ,□□□□□□□□□□ IOProc mmioRead □ mmioWrite □ □ 

□ □ □ □ IOProc, □ □□□□□□□□□□□□□□□□□□ IOProc □□□□□□□ 
DosRead 〇 DosWriteQ 

□ □□□□□□□□□□□ I 〇 Pr 〇 c,[] □□□ MMIO — TRANSLATEDATA □□ □ 

□ □，□□□□□□ MMIOM — READ □ MMIOM— WRITE □□□□□□□□□□□□ 

□，□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□ 
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□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 



□ □□□□□ 

□ 4-8 □ □ □ □ □ M-Motion IOProc □ □ □ □ □ MMIOM — READ [ 
WRITE □ □ □ □ □ □ 



case Myn 〇 M- 

{ 



* Declare Local Variables 

PMMFILESTATU S pVidlnf 〇； 

LONG rc; 

LONG lBytesToRead; 

* Check for valid MynOINFO block . 

if ( ! pmmioinfo) 

return (MMIO. ERROR) ; 

* Set up our working file status variable . 
pVidInf 〇 = (PMMFILESTATUS) pmmioinfo- 〉 pExtraInf 〇 Struct; 

* Is Translate Data off ? 

if ( ! (pmmioinfo- > ulTranslate & MMIO. TRANSIATEDATA) ) 






氺 



* Since no translation, provide exact number of bytes req 

if ( ! lParaml ) 

return (MMIO. ERROR) ; 

rc = mmioRead (pVidlnfo- > hmidoSS, 

(PV 〇 ID) lParaml, 

(ULONG) lParam2) ; 



return (rc) ; 




□ □ □ □ □ 
□ □ □ □ □ 

MMIOM 
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氺 



Otherwise, Translate Data is on . . . 



* Ensure we do NOT write more data out than is remaining 

* in the buffer . The length of read was requested in 

* image bytes, so confirm that there are that many of 

* virtual bytes remaining . 

if ( (ULONG) (pVidlnfo- > IlmgBytePos + lParam2) > 
pVidlnf o - > ul ImgTotalBytes 
lBytesToRead = 

pVidlnfo- > ullmgTotal Bytes- pVidlnfo- > IlmgBytePos; 

else 

lBytesToRead = (ULONG) lParam2; 

* Perform this block on ALL reads . The image data should 

* be in the RGB buffer at this point, and can be handed 

* to the application . 

氺 

* Conveniently, the virtual image position is the same 

* as the RGB buffer position, since both are 24 bit- RGB 

memcpy ( (PVOID) lParaml , 

& (pVidlnfo- > IpRGBBuf [pVidlnfo- > IlmgBytePos ] ) , 
lBytesToRead) ; 

* Move RGB buffer pointer forward by number of bytes read . 

* The Img buf fer p 〇 s is identical since both are 24 bits • 

pVidlnfo- 〉 IlmgBytePos += lBytesToRead; 



return ( lBytesToRead) ; 

} / * end case of MMIOM. 



*/ 



case MMIOM- WRITE; 

{ 



* Declare Local Variables . 



PMMFILESTATUS 

USHORT 



pVidlnfo; 
us Bit Count; 
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LONG 



ULONG 



lBytesWr itt en ; 
ul ImgBytesT 〇 Wr ite ; 



* Check for valid MMIOINFO block . 

if ( ! pmmioinfo) 

return (MMIO- ERROR) ; 

* Set up our working variable MMFILE STATUS • 
pVidInf 〇 = (PMMFILESTATUS) prrmi 〇 info->pExtraInf 〇 Struct; 

* See if a Set Header has been done on this file . 
if ( ( ! pVidlnfo) II ( ! pVidlnfo- > bSetHeader) ) 



return (MMIO. ERROR) ; 



if ( ! (pmmioinfo > ulTranslate & MMIO. TRANSIATEDATA) ) 



* Translation is off, take amount of bytes sent and 

* write to the file . 

* Ensure that there is a data buffer to write from . 
****************************， 

if ( ! IParamI ) 

return (MMIO. ERROR) ; 

lBytesWritten = rrimioWrite (pVidlnfo- > hmmioSS, 

(PVOID) IParamI, 



(ULONG) lParam2 ) ; 



return (lBytesWritten); 



* Translation is on . 

* Set up local variables . 



usB it Count : 
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pVidlnfo- >mmImgHdr imiXDIBHeader •BMPInfoHeaderZ .cBitCount; 



* Ensure we do not attenpt to write past the end of the 

* buffer " • 

******************************， 
if ( (ULONG) (pVidlnfo- > IlmgBytePos + lParam2) > 
pVidlnfo- > ullmgTotalBytes) 
ullmgBytesToWrite = 

pVidlnfo- > ullmgTotalBytes- pVidlnfo- > IlmgBytePos; 

else 

ullmgBytesToWrite = (ULONG) lParam2; 

* Write the data into the image buffer . It will be converted to 

* RGB, then YUV when the file is closed . This allows the 

* application to seek to arbitrary positions within the 

* image in terms of the bit^ pel, etc they are writing . 
******************************， 

memcpy ( & (pVidlnfo- > lplmgBuf [pVidlnfo > IlmgBytePos] ) , 

(PVOID) IParamI , 
ullmgBytesToWrite) ; 

/ * Update current posit ion in the image buf fer */ 
pVidlnfo- > IlmgBytePos + = ullmgBytesToWrite; 



return (ullmgBytesToWrite) ; 

} / * end case of MMI 〇 M_ 1A7RITE 氺乂 



/ 氺 

* If the IOProc has a child IOProc, then pass the message 

* on t 〇 the Child, otherwise return A Unsupported Message 
*/ 

default : 

{ 

/ * 

* Declare Local Variables . 

*/ 

PMMFILESTATUS pVidlnfo; 

LONG lRc; 

* Check for valid MynOINFO block . 
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if ( ! pmmioinfo) 

return (MMIO- ERROR) ; 



Set up our working variable MMFILESTATUS • 




pVidInf 〇 = (PMMFILESTATUS) pmmioinfo 〉 pExtraInf 〇 Struct; 
if (pVidlnfo ! = NULL & & pVidlnfo- 〉 hmmioSS) 



IRC = mmioSendMessage (pVidlnfo- > hrtimioSS, 

usMsg, 
lParaml r 
lParam2 ) ; 

if ( ! IRC) 

pmmioinfo- > ulErrorRet = mmioGetLastError (pVidlnfo- > hrrmioSS) ; 
return (IRC); 

} 

else 
{ 

if (pmmioinfo ! = NULL) 

pmmioinfo > ulErrorRet = MMIOERR. UNSUPPORTED. MESSAGE; 
return (MMIOERR- UNSUPPORTED- MESSAGE) ; 

} 

} / * end case of Default */ 

/ f end SWITCH statement for MMIO mes sages */ 
return (0); 

} / * end of window procedure */ 

□ 4-8 MMIOM— READ □ MMIOM — WRITE □□ (MMOTPROC .C) 

4 4 3 MMIOM.SEEK 

□ □ □ IOProc □□□□□□□□□□□□□□□□□□□□□□，□□□□□□□ 

□ □□□□□，□□□□□□，□□□□□□□□□□□□□□□□□□ I 〇 Pr 〇 c □ □ □ 

□ □□□□□□□□□□□□□□□□□□□□□ IOProc □□□ mmioSeek □□□□ □ 

□ □ IOProcO □□□□ IOProc □□□□ DOSSetFilePtr □□□□□□□□□□□□□□ 

□ □□□□，□□□□□ BND □□□□□ mmioSeek □□□□□□□□□□□□□□□ 

□ □ □ □ IOProc □□□□□□□□□□□□□□□□□ 

□ 4-9 □□□□□ M- Motion IOProc □□□□ MMIOM— SEEK □□□□□ □ 
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case MMIOM- SEEK: 






Set up locals . 






PMMFILESTATU S pVidlnfo; 



LONG 



LONG 

SHORT 



INewFi leP 〇 s it ion ; 

lPosDesired; 

sSeekMode; 



* Check to make sure MMIOINFO block is valid . 



if ( ! pmmioinfo) 

return (MMIO- ERROR) ; 



* Set up our working file status variable . 

pVidInf 〇 = (PMMFILESTATUS) pmmioinfo- >pExtraInf 〇 Struct; 

lPosDesired= lParaml; 
sSeekMode =( SHORT) lParam2 ; 

* Is Translate Data on ? 

if (pmmioinfo >ul Translate & MMI 〇 - TRANSLATEDATA) 



* Attenpt t 〇 move the Image buffer pointer to the 

* desired location .App sends SEEK requests in 

* positions relative to the image planes & bit^ pel 

* We must also convert this to RGB positions 
****************************， 

switch (sSeekMode) 



case SEEK. SET; 



INewFilePosition = lPosDesired; 
break; 



case SEEK. CUR; 
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INewFilePosition = pVidlnf o- > IlmgBytePos + lPosDesired; 
break; 



case SEEK. END; 

{ 

INewFilePosition = 

pVidlnfo- > ullmgTotalBytes + = lPosDesired; 

break; 



default: 

return (MMIO. ERROR) ; 

} 

* Make sure seek did not go before start of file . 

* If s 〇 ， then don t change anything, just return an error 

if (INewFilePosition < 0) 

{ 

return (MM I 〇 - ERROR) ; 

} 

* Make sure seek did not go past the end of file . 

if (INewFilePosition > (LONG) pVidlnfo- > ullmgTotalBytes) 
INewFilePosition = pVidlnfo- > ullmgTotalBytes; 

pVidlnfo- > IlmgBytePos = INewFilePosition; 



return (pVidlnfo- > IlmgBytePos) ; 

} / * end IF DATA TRANSLATED */ 

* Translate Data is OFF . . . 

* if this is a seek from the beginning of the file, 

* we must account for and pass the header 

if (lParam2= = SEEK- SET) 

lP 〇 sDesired+ =My 〇 TI 〇 N- HEADER- SIZE; 



INewFilePosition = rrimioSeek (pVidlnfo- > hrtimioSS, 

lPosDesired, 
sSeekMode) ; 
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* Ensure we did not move to within the header 



if ( (INewFilePosition ! = MV [ 工 〇 _ ERROR) & & 

( INewFilePosition < MyDTIOlNL HEADER _ SIZE) ) 

{ 

INewFilePosition = mmioSeek (pVidlnfo- > hmrdoSS, 

(LONG) MMOTION- HEADER- SIZE, 
SEEK. SET); 




Return new position . Always remove the length of the 



* header from the this position value 

if (INewFilePosition ! =My[IO- ERROR) 

INewFilePosition- =My 〇 TI 〇 N- HEADER- SIZE; 



return (INewFilePosition) ; 

} / * end case of MMIOM. SEEK */ 



□ 4-9 MMIOM. SEEKD □ (MMOTPROC .C) 

4 4 4 MMIOM. CLOSE 

□ □□□□□□□□□ IOProc □□，□□□□□□□□□□□ mmioClose □ □ □ □ 
mmioFlush □□□□□□]/0□□□(□□□□□□ IOProc □□□□ )□ 

□ □□□ IOProc □□□□□ HMMIO □□□ mmioClose □□□□□□□，□□□□ 

□ □□□ mmioClose □□ MMIO- FHOPEN □□□□□□□□□□□□□□□□□□□ 

□ □ □ 

□ 4-10 □□□□□ M- Motion IOProcd □□□ MMIOM — CLOSE] □□□□ □ 



Case MMI CM- CLOSE 

{ 

* Declare local variables . 

PMMFILESTATUS pVidlnfo; / * motionlOProc instance data */ 

ULONG ulHeight; / * 工 mage height */ 
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USHORT 



usBit Count; 



*/ 



/ * 工 mage width. 


including overflow in lbpp & 4bpp 


*/ 


ULONG 


ul ImgPelW idth ; 








PBYTE 


lpYUVLine; 


/ * 


one line of packed YUV 


*/ 


LONG 


1 YUVBytes PerLine ; 








ULONG 


ulMaxPelW idth ; 


/ * 


# pels on 4- pel boundaries 


*/ 


/ * # pels on a 、 


fUV line in the output file 


*/ 


ULONG 


ul YUVPelW idth ; 








ULONG 


ulRGBMaxBytesPerLine; / 


* # bytes on 冬 pel bounds 


*/ 


PBYTE 


IpRGBLine; 


/ * 


One line of 24bit RGB 


*/ 


PBYTE 


lplmgBufPtr; 


/ * 


Current loc in RGB image buf 


*/ 


LONG 


lRGBBytes PerLine ; 


/ * 


# bytes on a line in image 


*/ 


ULONG 


ulRowCount; 


/ * 


loop counter 


*/ 


LONG 


lBytesWr i tten ; 


/ * 


# bytes output on a write 


*/ 


LONG 


IRetCode; 








USHORT 


rc; 









* Check for valid ]yiMI 〇 INF 〇 block • 

if ( ! pmmioinfo) 

return (MyilO. ERROR) ; 



* Set up our working file status variable . 
pVidInf 〇 = (PMMFILESTATUS) pmmioinfo >pExtraInf 〇 St rue t; 

* Assume success for the moment . . . . 
lRetCode = MMIO. SUCCESS; 



* see if we are in Write mode and have a buf fer to write out . 

* We have no image buffer in UNTRANSLATED mode . 

if ( (pmmioinfo 〉 ulFlags & M^ITE) & & (pVidlnfo- > lplmgBuf) ) 

{ 

* The buffer shoule be in palettized or 24- bit RGB 

* We must convert it to YUV to be written to the file . 
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* The buffer should be corrplete . If not, then we 

* should still close, but can flag an error to the 

* user that the data may be corrupted . The only way 

* we can estimate if this is true is to check the final 

* position . If not at the end . . . 



if (pVidlnfo > IlmgBytePos 



(LONG) pVidlnfo- > ullmgTotalBytes) 



IRetCode = My[IO. WARNING; 



* Set up width and height of image in the buffer . 

ulHeight = pVidlnfo- > mmlmgHdr BMPInf 〇 Header2 .cy; 

usBitCount = 

pVidlnfo >mmImgHdr mnXDIBHeader BMPInf 〇 Header2 成 :1 七 (1! 〇 1111 七 ; 

* Get the 1 ine width in YUV pel s and packed bytes . 

ulYUVPelWidth= pVidlnfo- > mmotHeader inmXlen; 
lYUVBytesPerLine = (LONG) (ulYUVPelWidth * 3) > > 1; 

* This changes from QS/ 2 PM b 〇 tt 〇 rrh up bitmap form 

* to M- Motion s top-down form . Flip all pad, boundary 



bytes as well 



ImgBufferFlip ( (PBYTE) pVidlnfo- > lplmgBuf, 

pVidlnfo- > ullmgPaddedBytesperLine, 
ulHeight) ; 

* Determine number of POSSIBLE pels on a line, tho some 

* may be overflow in lbpp and 4bpp modes . 



* From that, we can calc the number of RGB pels we will 

* create to represent this line . 

ulImgPelWidth= (pVidlnfo- > ullmgpelBytesPerLine < < 3) / 

usBitCount; 

lRGBBytesperLine = ullmgPelWidth * 3 ; 
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* Ensure the width is on a 4- pel boundary, necessary for 

* M- Motion .We will buffer with black 

* * * * THIS IS ONLY NECESSARY FOR 外 MOTION IMAGES 

if (ullmgPelWidth % 4) 

ulMaxPelWidth = ( ( (ullmgPelWidth > > 2) +1) < < 2) ; 
else 

ullMlaxpelWidth = ullmgPelWidth; 

' * # RGB byte^ line = # pels * 3 byte^ pel */ 
ulRGBMaxBytesPerLine = ulMaxPelWidth * 3; 



* Create a buffer for one line of RGB data^ accounting for 

* the 4- pel boundary required .Extra bytes won t be used . 

if (DosAllocMem ( (PPVOID) &lpRGBLine, 
ul RGBlMfexByt esPerLine , 
f ALLOC) ) 
return (MV [ 工 〇 _ ERROR) ; 



* Create a buffer for one line of YUV data . 

if (DosAllocMem ( (PPVOIO) &lpYUVLine, 

1 Y UVByt e sPe rLine , 
fALLOC) ) 
return (MMIO. ERROR) ; 



* Zero out RGB buf fer to cover for any extra black pels 

* needed at the end . 



memset (IpRGBLine, 0, ulRGBlMfexBytesPerLine); 

* Initialize start position of RGB buffer . 
lplmgBufPtr = pVidlnfo- > lplmgBuf; 



* process Image Buffer - Save to file 

* Place "you/ processing code here, if full image 
buffering is performed . 



氺 




氺 



For M- Motion: 



氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 



LOOP 

1 . Convert and copy a line of lbpp, 4bpp, 8 bpp or 
24bpp data into a terrporary 24 bpp RGB line . 
This line may contain overflow garbage 
pels from lbpp and 4bpp modes (where 
width does not fall on even byte boundaries .) 

2 • Convert the terrporary RGB line contents into a 
YUV line . ONLY that data necessary converted . 
Overflow from bitmap data ignored . 

3 . Write the YUV line to the file 

for ( ulRowCount = 0 ; 

ulRowCount < ulHeight; 
ulRowCount + + ) 

{ 

* Convert 1 line of Image dat 彐 into RGB data 

switch (usBit Count) 

{ 

case 1 : 

{ 

/ * Convert lbpp padded image buffer into 24-bit */ 
/ * RGB line buffer, v/ pads */ 

Convert 1 Bit T 〇 24 Bit ( 

(PBYTE) lplmgBufPtr, 

(PRGB) IpRGBLine, 

(PRGB) & (pVidlnfo > rgbPalette) r 
pVidlnfo- > ullmgPelBytesPerLine) ; 

break; 

} 



case 4 : 

{ 

/ * Convert data from app buffer into 24- bit and */ 
/ * copy into image buffer */ 

Con vert 4 BitTo24Bit ( 

(PBYTE) lplmgBufPtr, 

(PRGB) IpRGBLine, 

(PRGB) & (pVidlnfo > rgbPalette) f 
pVidlnfo- > ullmgPelBytesPerLine) ; 
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break; 



case 8 : 

{ 

/ * Convert data from app buffer into 24- bit and */ 
/ * copy into image buffer */ 

Convert 8 Bit T 〇 2 4Bit ( 

(PBYTE) lplmgBufPtr, 

(PRGB) IpRGBLine, 

(PRGB) & (pVidlnfo > rgbPalette ) , 
pVidlnfo- > ullmgPelBytesPerLine) ; 

break; 



case 24: 

{ 

/ * Copy raw RGB data from the image buffer into */ 
/ * the terrporary */ 

/ * RGB line . Only copy those pels necessary . */ 
/ * No conversion required */ 

memcpy ( (PVOID) IpRGBLine, 

(PVOID) lplmgBufPtr, 
ulYUVPelWidth * 3) ; 

break; 

} 

} / * end of Switch for Bit Conversion block */ 



* convert one line at a time from RGB to YUV . 

Co nvertOneL ineRGBt oYUV ( IpRGBLine , 

lpYUVLine, 
ulYUVPelWidth) ; 



* Write out line of YUV data to the file . 

lBytesWritten = mrdoWrite (pVidlnfo- > hmrdoSS, 

(PVOID) lpYUVLine, 
lYUVBytesPerLine) ; 

/ * Check if error or EOF */ 
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if ( lBytesWritt en ! = lYUVBytesPerLine) 



lRetCode= lBytesWritten; 
break; 

} 

* Make sure bitmap image buffer pointer is correct 

* for next line to be converted .Move forward ALL 

* the bytes in the bitmap line, including overflow 

* and pad bytes . 

lplmgBufPtr + = pVidlnfo- 〉 ullmgPaddedBytesPerLine; 

} 

* Free terrp buffers . 

if (IpRGBLine) 

{ 

DosFreeMem ( (PVOID) IpRGBLine) ; 

} 

if (lpYUVLine) 

{ 

DosFreeMem ( (PVOID) lpYUVLine) ; 

} 

} / * end IF WRITE & IMAGE BUFFER block */ 

* Free the RGB buf fer, if it exists, that was created 

* for the translated READ operations . 



if (pVidlnfo- > IpRGBBuf ) 



DosFreeMem ( (PVOID) pVidlnfo- > IpRGBBuf) ; 

} 

* Free the IMG buf fer, if it exists, that was created 

* for the translated VJRITE operations • 



if (pVidlnfo- > lplmgBuf ) 
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DosFreeMem ( (PVOID) pVidlnfo 〉 lplmgBuf) ; 




* Close the file with mmioClose . 

rc = mmioClose (pVidlnfo- > hmmioSS, 0) ; 
DosFreeMem ( (PVOID) pVidlnfo) ; 

if (rc ! = miO. SUCCESS) 
return (rc) ; 



return (IRetCode); 

} / 氺 end case of MMICM- CLOSE 氺 / 




4-10 MMIOM- CLOSED 〇 (MMOTPROC .C) 



4 4 5 MMIOM. IDE ISTTIFYFILE 



IOProc □□□□□□□□□□□□□□ IOProc □□□□□□□□□，□□ 
mmioOpen □□□□□□□□□□□□□□□□□ MMIOM — IDENTIFYFILED 

□ □□□□□ IOProc, □□□□□□□，□□□□□ IOProc □□□□□□ lParm2 Q 

□ □□□□□ mmioRead □□□□□□□ 4- M- Motion □□，□ IOProc □ 

□ TRUE,Q □ □ □ FALSED 



case MMIOM. IDENTIFYFILE: 

{ 

* Declare local variables . 



氺 氺 






MyDTIONHEADER 


mmotHeader : 


/ * 


M- Motion structure variable 


*/ 


HMMIO 


hrtinioTerrp; 


/ * 


MMIO File Handle 


*/ 


ULONG 


ulWidth; 








ULONG 


ulHeight; 








ULONG 


u IRequiredFileLengt h ; 




ULONG 


u lActualFi leLength; 






BOOL 


fValidMMotionFile : 


= FALSE; 




ULONG 


ulTerrpFlags 


= 剛工〇_ ： 


READ 1 My[IO. DENYWRITE 1 




- NOIDENTIFY; 














/ * 


Flags used for terrp open 


*/ 






/ * 


and close 


*/ 


/ 氺氺 氺氺氺 


* * * * * * 


氺 氺氺氺 




氺 
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* We need either a file name (IP araml) or file handle (lParam2) 

if ( ! IParamI & & ! lParam2) 
return (MMIO. ERROR) ; 

/ * Copy the file handle ^ assuming one was provided . . . */ 
hrtimioTerrp= (HMMIO) lParam2; 

* If no handle, then open the file using the string name 

if ( ! hrtimioTerrp) 

{ 

if ( ! (hmrdoTerrp = inrdoCpen ( (PSZ) IParamI, 

NULL, 

ulTerrpFlags) ) ) 

{ 

return (MMIO. ERROR) ; 



* Read in enough bytes to check out file . 

if (sizeof (MMDTIONHEADER) ! = 

mmioRead (hrtinioTerrp, 

(PVOID) & mmo t Header f 

(ULONG) sizeof (MMDTIONHEADER) ) ) 



* Fail so close file and then return . 

if ( ! lParam2) / * Don t close handle if provided to us */ 
nrnioClose (hmmioTerrp, 0) ; 
return (MMIO- ERROR) ; 



* Close file before returning . 

if ( ! lParam2) / * Don t close handle if provided to us */ 
nrnioClose (hmmioTerrp, 0) ; 
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氺 



Check validity of file and return result . 






if (memcrrp (mmot Header irinlD, ff Y[]W\2C r 6) = = 0) 

{ 

ulWidth= irmot Header mmXlen; 
ulHeight = mmotHeader rnmYlen; 

/ * Calculate what the length of the file SHOULD be based on the */ 
/ * header contents */ 

ulRequiredFileLength = (( (ul Width > > 2) * 6) * ulHeight) + 

sizeof (MyDTIQNHEADER); 

/ * Query what the ACTUAL length of the file is */ 

ulActualFileLength = (ULONG) mmioSeek (hirmioTerrp, 0, SEEK. END) ; 



/ * If these don’ t match, then it isn't a VALID M~M 〇 ti 〇 n file 
/ * - regardless of what the header says . 

if ( ulRequiredFileLength = = ulActualFileLength) 
fValidiyiMotionFile = TRUE; 
else 

f ValidiyiMot ionFile = FALSE; 

} / * end header check block */ 

* Close file before returning . 



*/ 

*/ 



if ( ! lParam2) / * Don t close handle if provided to us 
mmioClose (hmmioTerrp, 0) ; 

if ( fVal icMyiotionFile) 
return (MV [工 〇_ SUCCESS) ; 
else 

return (MMIO- ERROR) ; 

} / * end case of MMIOM- IDENTIFYFILE 氺 / 



*/ 



□ 4-11 MMIOM- IDENTIFYFILED □ (MMOTPROC .C) 

4 4 6 MMIOM . GETFORMATINFO 

□ □□□□ IOProc □□□□□□ MMIO □□□□ MMFORMATINFO □□，□□ □ 

□ □□□□□□□ IOProc □□□□□□□□□□□；□□,□□□ DFOURCC □ □ □ □ 

□ □□□□□□□□ IOProc □□□□□□□□□ IOProc □□□□□□□□□□□，□ 
mmioGetFormatlnfo □□□□□□□□□ MMFORMATINFO □□□□□□□□□□□ 

□ □□□□ ulStrucLen, fccIOProc， ulMediaType □ ulFlags □□□ IOProc □□□□□ □ 
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□ □□□□□□□□□□□□□，□□□□ NLS □□□,□□□□□□□□□□□□□ 
(ulCodePage, ulLanguage, INameLength □ □ aulDefaultFormatExt □ □ )□ 

□ 4-12 □ □ □ □ □ M-Motion I OP roc □ □ □ □ MMIOM^ GETFORMATINFO □ □ 

□ □ 

case MMIOM— GETFORMATINFO: 




PMMF ORMAT INFO pmm format info; 




Set pointer t 〇 MMFORMATINFO structure • 




pmmf ormatinf o = (PMMFORMATINFO) lParaml ; 




Fill in the values for the MMFORMATI1NIFO structure . 




prnmf ormatinf o- > ulStructLen = size of (MMFORMATINFO) ; 
pnnrrif ormatinf o- > fccIOProc = FOURCC. MVCT; 
pmmf ormatinf o > ulIOProcType = MMI〇_ IOPROC- FILEFORMAT; 
pninf ormatinf c> > ulMediaType = MVIIO- MED IATYPE- IMAGE/ 

pmmf annatinfo > ulFlags = jyMI〇_ CANREAD TRANSLATED 

MMIO. CANREAD UNTRANSLATED 
剛工〇_ CANWRITETRANSIATED 
剛工〇_ CANWRITEUNTRANSLATED 
MV [工 〇_ CANREADWRITEUNTRANSLATED 
應工〇_ CANSEEKTRANSLATED 
My[I〇. CANSEEKUNTRANSIATED; 

strcpy ( (PSZ) prtimformatinfo- > szDefaultFormatExt, pszMotionExt) ; 
if (GetNLSData ( & prnmf ormatinf o- > ulCodePage, 

&prtimf ormatinf o- > ulLanguage ) ) 

{ 

return ( -lL ) 

} 

if (GetFormatStringLength ( FOURCC. MVCT, 

& (pmmf ormatinf o- > INameLength) ) ) 

{ 

return ( - 1 L ) ; 
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* Return success back to the application . 



return (MV [工 〇_ SUCCESS); 

} / 氺 end case of MMIOM- GETFORMATINFO 氺/ 




4 4 8 MMIOM . QUERYHEADERLENGTH 

□ □□□□ lOProc □□□ mmioOpen □□□□□□□□□□□□□□□□□□□□ 
mmioQueryHeaderLength □□□□□□ MMIOM QUERYHEADERLENGTH □□□ □ 

□ mmioGetHeader[] □□□□□□□□□□□□□□□□□□□□，□□□□□□□□ 

□ □ □ 
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□ □□□□□□，□□ mmioSeek mmio Read , 

□ □□□□□□□□□□□□□□□□□□□□□□，□□ mmioQueryHeaderLength □ 

□ □□□□□□□□□□□□□□□□□□□□□□□，□□□□□ I 〇 Pr 〇 c □ □ □ □ □ 

□ □□□□□□□□□□□□□□□□□□!" 〇 ，□□□ mmioRead □□□，□□□□□ 

□ □□□□□□□□ mmio □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □，□□□□□□□□□□□□□□□□□ 

□ 4-14 □ □ □ □ □ M- Motion IOProc □ □ □ □ MMIOM QUERYHEADER- 
LENGTHD □ □ □ □ □ 



case MMIOM- QUERYHEADERLENGTH : 




* If there is no MynOINFO block then return an error . 

if ( ! pmmioinfo) 
return (0) ; 




If header is in translated mode then return the media 
type specific structure size . 




if (pmmioinfo- >ulTran slate & MMIO. TRANSIATEHEADER) 



return (sizeof (MMIMAGEHEADER)); 
else 



* Header is not in translated mode so return the size 

* of the M- Motion header . 




return (sizeof (MMOTIONHEADER)) ; 
break; 

} / * end case of lyiMIOM. QUERYHEADERLENGTH */ 



□ 4-14 MMIOM- QUERYHEADERLENGTH □□ (MMOTPROC .C) 

4 4 9 MMIOM. GETHEADER 

□ □□□□ IOProc □□□□□ mmioOpen □□□□□□□□□□□□□□□□□ 

□ ;□□，□□□□[□□□□□□□□□□□□□□□□□□□□□□□□□ mmioRead 

□ □，□□□□□□□，□□□□ lParam2 □□□□ □ 

□ □□□□ TRUE □，□□ IOProc □□□□□□□□□□□□□□□□□ IOProc 

□ □□□□□□□□□□□□□□□□□□□□ 

□ 4-15 □ □ □ □ □ M- Motion IOProc □□□□ MMIOM — GETHEADER □□□ □ 
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caseMMIOM- GETHEADER: 

{ 

* Declare local variables . 

PMMF ILESTATUS pVi dlnf 〇； 

* Check for valid MMIOINFO block . 

if ( ! pmmioinfo) 
return (0); 



* Set up our working file status variable . 

pVidlnfo = (PMMFILESTATUS) pmmioinfo 〉 pExtralnfoStruct; 

* Getheader only valid in READ or REAE/ V\7RITE mode . 

* There is no header t 〇 get in WRITE mode .Vfe 

* must aiso have a valid file handle to read from 

if ( (pmmioinfo- 〉 ulFlags & My[IO- WRITE) II 
( ! (pVidlnfo- > hrtimioSS) ) ) 
return (0) ; 



* Check for Translation mode . 
if ( ! (pmmioinfo > ulTranslate & 應工〇 _ TRANS LATEHEADER) ) 



* Translation is off . 

if (lPararri2 < sizeof (MyDTIONHEADER) ) 

{ 

pmrnioinfo- > ulErrorRet = MMIOERR. INVZ\LID. BUFFER. LENGTH; 
return (0) ; 



if ( ! IParamI ) 
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pmmioinfc^ > ulErrorRet = MMIOERR- INVALID- STRUCTURE; 
return (0) ; 



* Read in first 16 bytes to fill up M- Motion header . 
****************************， 
memcpy ( (PVOID) lParaml, 

(PVOID) &pVidInfo- > mmotHeader^ 
sizeof (MyDTIONHEADER) ) ; 

/ * Indicate that the header has been set, which */ 

/ * is meaningless in read mode, but allows the */ 

/ * application to do writes in reacj^ write mode */ 

pVidlnfo- 〉 bSetHeader = TRUE; 

return (sizeof (My 〇 TI 〇 NHEADER)); 

} / * end IF NOT TRANSLATED block */ 

* TRANSLATION IS ON 
if (lParam2 < sizeof (MyUMAGEHEADER) ) 



pmmi 〇 info>ulErr 〇 rRet = MMI 〇 ERR_ INVALID - BUFFER- LENGTH; 



return (0); 



if ( ! IParamI ) 



pmmi 〇 info>ulErr 〇 rRet = MMIOERR- INVALID- STRUCTURE; 
return (0); 



memcpy ( (PVOID) IParamI, 

(PVOID) &pVidInfo > mmlmgHdrv 
sizeof (MMIMAGEHEADER) ) ; 

return (sizeof (MMIMAGEHEADER)); 

} / * end case of MMIOM. GET HEADER */ 



□ 4-15 MMIOM- GETHEADER □ □ (MMOTPROC .C) 

4 4 JO MMIOM. SETHEADER 



□ □□□□ lOProc □□□□□ mmioOpen □□□□□□□□□□□□□□□□□ 
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□ □□□□:□□□□□□□□□□□□□□□□□ 

□ □□□□ TRUE IOProc □□□□□□□□□□□□□□□ IOProc □ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□ 

□ 4-16 □ □ □ □ □ M- Motion IOProc □ □ □ □ MMIOM — SETHEADER □ □ □ □ 

□ □ 



caseMMIOM. SETHEADER: 




* Declare local variables . 



PMMIMAGEHEADER 


pMMImgHdr; 


PMMFILESTATUS 


pVidlnfo; 


USHORT 


usNumColors; 


ULONG 


ul ImgBit spe rLine ; 


ULONG 


ul ImgBytesperLine ; 


ULONG 


ul BytesWr it ten ; 


ULONG 


ul Width; 


ULONG 


ul4PelWidth; 


ULONG 


ul Height; 


USHORT 


usPlanes; 


USHORT 


us Bit Count; 


USHORT 


usPadBytes; 



* Check for valid MMIOINFO block . 

if ( ! pmmioinfo) 

return (MMIO. ERROR) ; 




* Set up our working variable MMFILESTATUS • 



pVidlnfo: (PMMFILESTATUS) pmmioinfo- 〉 pExtraInf 〇 Struct; 

* Only allow this function if we are in WRITE mode 

* And only if we have not already set the header 

if ((! pmmioinfo > ulFlags & Myn 〇 - VJRITE) ) II 




( ! (pVidlnfo- > hmidoSS) ) I I 
(pVidlnfo- > bSetHeader) ) 
return (0); 
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* Make sure lParaml is a valid pointer 
******************************， 

if ( ! lParaml ) 

{ 

pmmioinfo- > ulErrorRet = MMIOERR. INVZ^LID. STRUCTURE; 
return (0); 

} 

* Header is not in translated mode . 
******************************， 

if ( ! (pmmioinfo > ulTranslate & MMIO. TRANSLATEHEADER) ) 

{ 

* Make sure lParam2 is correct size 
if (lParam2 ! = MMOTION. HEADER. SIZE) 



pmmioinfo > ulErrorRet = MMIOERR- INVALID - BUFFER- LENGTH; 
return (0); 

} 

* Ensure that the header at least begins with 〃 YUVl 2 Cf 
^***************************^ 

if (strncrrp ((char * ) lParaml , "YUV12C"’ ， 6) ) 

{ 

pmmioinfo- > ulErrorRet = MyilOERR. INVALID. STRUCTURE; 
return (0) ; 

} 

* Take 16 byte buffer (lParaml ) , write to file and . 

* copy to internal structure . 
****************************， 

memcpy ( (PVOID) &pVidInfo- > rnmotHeader, 

(PVOID) lParaml, (ULONG) MOTION. HEADER. SIZE) ; 
ulBytesWritten = rtimioWrite (pVidlnfo- 〉 hmmioSS, 

(PVOID) lParaml, 

(ULONG) MyDTIQN- HEADER- SIZE) ; 
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* Check for an error on the write . . 

if (ulBytesWritten ! = MyCTI〇N_ HEADER- SIZE) 
return (0); / * 0 indicates error */ 

* Success . . . 

pVidlnfo 〉 hSetHeader = TRUE; 
return (sizeof (MyDTIONHEADER)); 

} / * end IF NOT TRANSLATED block */ 

* Header is translated . 

* Create local pointer media specific structure . 
pMMImgHdr = (PMy [工 MAGEHEADER) lParaml; 



氺 



* Check for validity of header contents supplied 

* ~ Length must be that of the standard header 

* — NO Corrpression 
1 plane 

* 24, 8, 4 or 1 bpp 

us BitCount = pMMImgHdr- >mmXDIBHeader BMPInf〇Header2 .cBitCount; 
if ( (pMy [工 mgHdr- > mmXDIBHeader •BMPInf〇Header2 .ulConpression ! = 
BCA. UNCOMP) II 

(pMy [工 mgHdr- 〉 mmXDIBHeader •BMPInfoHeaderZ .cPlanes ! = 1 ) II 
( ! ( (usBit Count = = 24) II (usBit Count = = 8) II 
(usBit Count = = 4) I I (usBit Count = = 1)) ) 

) 

{ 

pmmioinfo > ulErrorRet = MMIOERR- INV?\LID- STRUCTURE; 
return (0) ; 

} 

if (lParam2 ! = sizeof (MMIMAGEHEADER) ) 

{ 



pmmioinfo- > ulErrorRet = IVIMIOERR- INVZ^LID. BUFFER. LENGTH; 




return (0) ; 



* Corrplete MyDTIQNHEADER • 

memcpy ( (PVOID) &pVidInfo- > rrimotHeader jrmlD, / ， YUVl2C r， A 6) ; 
pV idlnf o- > mmotHeader inmXorg = 0; 
pV idlnf o > mmotHeader junYorg = 0; 

* Ensure we will save stuff on 4- pel boundaries when 

* we actually convert t 〇 YUV and pack the bits • 

* We dori t change what the user is actually going to 

* give us . The user thinks he is on 1-pel boundaries f 

* and that is how we buffer the RGB data . 

ul Width = pMy [ 工 mgHdr- > mmXDIBHeader BMPInf 〇 Header2 *cx; 

ul Height = piyiMImgHdr- > mmXDIBHeader BMPInf 〇 Header2 cy; 
if (ulWidth % 4) 

ul4PelWidth= ( ( (ulWidth > > 2) +1) < < 2) ; 
else 

ul4PelWidth = ulWidth; 

pVidlnfo- > mmotHeader imiXlen = (USHORT) ul4PelWidth; 
pVidlnfo- > mmotHeader inmYlen = (USHORT) ulHeight; 

* Write the M- Motion Header . 

ul BytesWr it ten = mmioWrite (pVidlnfo- > hmnioSS, 

(PVOID) & pVidlnfo- > mmotHeader, 
(ULONG) MyDTION. HEADER. SIZE) ; 



* Check for an error on the write . . . 

if (ulBytesWritten ! = MyDTION- HEADER- SIZE) 
return (0); 

* Flag that MMIOM. SETHEADER has been done . It can only 

* be done ONCE for a file . All future attenpts will 

* be flagged as errors . 
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pVidlnfo- > bSetHeader = TRUE; 

* Create copy of MMIMAGEHEADER for future use . 
******************************， 

pV idlnf o- > mmlmgHdr = * pMMImgHdr; 

* Check bitcount, set palette if less than 24 • 
******************************， 

if (usB it Count < 24) 



* Find out how many colors are in the palette . 
usNumColors = (USHORT) ( 1 < < usBit Count) ; 



* Take the RGB2 palette and convert it to an RGB palette 

* Place the converted palette in MMFILESTATUS struct 

RGB2- To. RGB (pVidlnfo- > mmlmgHdr JomiColors, 

(PRGB) & (pVidlnfo- > rgbPalette ) , 
usNumColors) ; 



* We must allocate the buffer . The app will load the 

* buffer on subsequent write calls . 

usPlanes = pVidlnfo > mmlmgHdr BMP Inf 〇 Header2 jcPlanes; 



* Determine total Image size 

* Find bit s-per- line BEFORE padding and lbpp or 4bpp pel overflow 

ullmgBitsPerLine = ulWidth * usPlanes * usBit Count; 
ullmgBytesPerLine = ullmgBitsPerLine > > 3; 

* Account for extra pels not on an even byte boundary 

* for lbpp and 4bpp 

if (ullmgBitsPerLine % 8) 
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ullmgBytesPerLine + + ; 

pVidlnfo- > ullmgPelBytesPerLine = ullmgBytesPerLine; 



Ensure the row length in bytes accounts for byte padding . 

All bitmap data rows are aligned on LONQ" 4-BYTE boundaries . 
The data FROM an appl ication should always appear in this form 




usPadBytes = (USHORT) (ullmgBytesPerLine % 4) ; 
if (usPadBytes) 

ullmgBytesPerLine + = 4 - usPadBytes; 

pVidlnfo- > ullmgPaddedBytesPerLine = ullmgBytesPerLine; 
pVidlnfo- > ullmgTotalBytes = ullmgBytesPerLine * ulHeight; 




* Get space for full image buffer . 



if (DosAllocMem ( (PPVOID) & (pVidlnfo- > IplmgBuf) r 
pVidlnfo > ullmgTotalBytes, 
f ALLOC) ) 

return (MMIO. ERROR) ; 



* Set up initial pointer value within RGB buffer & image 




pVidlnfo- > IlmgBytePos = 0; 

return (sizeof (MyUMAGEHEADER)); 

} end case of MMIOM. SETHEADER */ 




□ +16 MMIOM. SETHEADER □ 〇 (MMOTPROC .C) 

4 5 CODEC □ □ 

□ □□□□□□□ Ultimotion IOProc (ULIOT)D □ \ TOOLKIT \ SAMPLES 

\ MM \ ULTIMOIOQ □□□),□□□□□□□□□□□□□□□□□□ DULIOT 
1 〇 □□□□ Ultimotion CODEC 

□ □□□□□□□□□□□, ULIOT □□□□□□□ CODEC □□□□□□□□，□□ 

□ □□□□□□□□□□ 

4 5 1 □ □ □ 
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1_ □□□□，□□□□□□□□□ CODECQ 
2. □ □ CODEC DLL □ □ □ 

3- □□□□□□ CODEC □ □ □ 

4. □ □ CODEC, □ □ □ □ □ □ 

5- □□□□,□□ CODECQ □ □ □ □ □ 

4511 □□□□□□□□ 

(FOURCC)D □□□□□□□(□□ 4-17 □)□□□□□□□□□□□□□□□□□□ 



LONG IOProcCpen (PIMMIOINFO pmmioinfo, PSZ pszFileName) { 



LONG 


rc^iyiMIO-SUCCESS; 


/ 


氺 


Return code . 


*/ 


LONG 


lFilePosition; 


/ 


氺 


Logical file position • 


*/ 


MMIOINFO 


Localmmioinf o ; 


/ 


氺 


For locally used . 


*/ 


PINSTANCE 


pinstance; 


/ 


氺 


Local work structure • 


*/ 



if (pmmioinfo = = NULL) return MMI 〇 _ ERROR; 



if (CheckMem( (PVOID)pmmi 〇 inf 〇， size 〇 f(MyiI 〇 INF 〇）， PAG- WRITE)) 
return MV [ 工 〇 _ ERROR; 



* Validate the open flags for this File Format IOProc 

* (INVALID- OPEN. FLAGS should be defined in the ff .h - file format 

* specific header file .) 















*/ 

*/ 

*/ 

*/ 

*/ 



if (pmmioinfo 〉 ulFlags & INVALID- 〇 PEN_ FLAGS) { 

pmmioinfo- > ulErrorRet = MMIOERR. INVALID. ACCESS. FLAG; 
return (My[IO- ERROR) ; 



ENTERCRITX; 

if ((pinstance= (P INSTANCE) HhpAllocMem (hheap, sizeof (INSTANCE))) 

= = NULL) { 

EXITCRIT; 

pmmioinfo- > ulErrorRet = MMIOERR. OUTOFMEiyDRY; 

return (MMIO- ERROR) ; / * Allocate work struct . */ 

} 

EXITCRIT; 



pmmioinfo > pExtralnfoStruct = (PVOID) pinstance; 

pmmioinfo- > fccIOProc= HEX. FOURCC. FFIO; / * Set for CODEC loading . */ 
iolnstancelnit (pinstance) ; 



Validate read flags before doing read initialization */ 
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if ( ( pmmioinfo- > ulFlags & IVIMIO. READ) & & 

! ( pmmioinfo- > ulFlags & INVALID. READ. FLAGS ) ) { 

/ * IOProc identifies Storage System */ 

memcpy ( &Localrrmioinfo, pmmioinfo, sizeof (MMIOINFO) ) ; 

Localmmioinfo plOProc = NULL; 

Localrrmioinfo iccIOProc = pmmioinfo- > fccChildlOProc; 

Localrrmioinfo ulFlags I = IVIMIO- NO IDENTIFY; / * Eliminate callbacks */ 
Localrrmioinfo ulFlags & = MMIO. ALLOCBUF; / * Force non- buffered open */ 

rc = ioIdentifyStorageSystem( &Localmmioinfo f pszFileName) ; 

if (rc ! =NMI 〇 _ SUCCESS) { / * if error, */ 

ioCleanUp(prnriioinfo) ; 
return ( rc) ; 

} 

/ * Allocate memory for pTerrpBuf fer which is used when */ 

/ * IOProcReadlnter Leaved is called . */ 



if (ENTERCRIT(rc) ) { 
ioCleanUp(prnmioinfo) ; 
return ( rc) ; 

} 

if ( (pinstance- > pTerrpBuf fer = HhpAllocMem(hheap f DEFAULTBUFFERSIZE) ) 
= = NULL) { 

EXITCRIT; 

ioCleanUp(prtimioinfo) ; 
return (MMIOERR. OUTOFMEMDRY) ; 

} 

EXITCRIT; 

pinstance- > ulTerrpBufferSize = DEFAULTBUFFERSIZE; 

/ * Cpen Movie file */ 



if ( prrimioinfo- > fccChildlOProc ! = FOURCC - MEM) { 
Localmmioinfo .cchBuffer = 0; 

Localmmioinfo .pchBuffer = NULL; 

} 

pinstance- > hrrmioFileHandle = mmioOpen (pszFileName, 
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&Localirmioinfo, MMIO- NOIDENTIFY) ; 

/ * Test file open error .*/ 
if (pinstance- > hrnmioFileHandle < = (HyMIO) 〇 L) { 
rc = Localmmioinfo ulErrorRet; 

} 

/ * Call file format specific open routine */ 



else if ( ! (rc= ffOpenRead(pirmioinfo, pinstance) ) ) { 
if ( ! (rc = ioAddTracksToMovieHeader (pinstance) ) ) { 

/ * Set lLogicalFilePos to a position pass the header 
/ * block to allow read occurring at the first byte of 
/ * non- header data . 

lFilePosition = ffSeekToDataBegin(prnmioinfo, pinstance) ; 
if (lFilePosition < MMI 〇 - SUCCESS) 
rc = My[IO. ERROR; 
else 

pinstance- > lFileCurrentPosition = lFilePosition; 



if (rc) { 

ioCleanUp (prnmioinfo) ; 
return (rc) ; 

} 

} 

/ * Validate Write flags before doing initialization */ 

# ifndef WORKSHOP 

if ( (prrmioinfo 〉 ulFlags & READWRITE I MyH 〇 - WRITE) ) & & 

! (pmmio info > ulF lags & INVALID. WRITE. FLAGS) ) { 

/ * Cpen the movie file */ 

memset (& Localmmioinfo, r \ 0 r sizeof (MMIOINFO) ) ; 
Localrtimioinfo plOProc = NULL; 

Localrtimioinfo iccIOProc = pmmioinfo- > fccChildlOProc; 
if (pmmioinfo- > fccChildlOProc ! = FOURCC. MEM) { 



Localmmioinfo .cchBuffer = 0; 
Localmmioinfo .pchBuffer = NULL; 




Localmmioinfo nlFlags I =MMIO. NOIDENTIFY; / * Eliminate callbacks */ 
Localrrmioinfo nlFlags & =My[IO- ALLOCBUF; / * Force non- buffered open . */ 

/ * MMIO may do buffering . */ 

pinstance- > hrtimioFileHandle = irmioOpen (pszFileName, &L 〇 calrrmi 〇 inf 〇， 

MMIO- READWRITE I 剛工〇 - NOIDENTIFY) ; 

if (pinstance- > hmmioFileHandle < = (HyMIO) 〇 L) / * Test file open error . */ 
rc= Localmmioinfo .ulErrorRet; 
else 

/ * Call file format specific open routine */ 
rc= ffOpenWrite(pmmi 〇 inf 〇 , pinstance) ; 

if (rc ! =0) { 

ioCleanUp( pmmioinfo) ; 
return ( rc) ; 

} 

} 

# else / * WORKSHOP next */ 

if ( (pmmioinfo- 〉 ulFlags & (MV [ 工 〇 _ READWRITE I MMIO- WRITE) ) & & 

! (pmmioinfo > ulF lags & INVALID- WRITE. FLAGS) ) { 

/ * Cpen the movie file */ 

memset (& Localmmioinfo, r \ 0 r sizeof (MMIOINFO) ) ; 

Localrnmioinfo plOProc = NULL; 

Localrrmioinfo •fccIOProc pmmioinfo- > fccChildlOProc; 

Localrnmioinfo jjlFlags = prtimioinfo- > ulFlags ; 

Localmmioinfo ulFlags I = MMIO- MDIDENTIFY; / * Eliminate callbacks */ 
Localirmioinfo jjlFlags & =My[IO. ALLOCBUF; / * Force non- buffered open . */ 

/ * MMIO may do buffering . */ 

if ( ! (pmmioinfo- > ulFlags & MyilO. CREATE) ) { 

rc = ioIdentifyStorageSystem( &Localmmioinfo A pszFileName) ; 

if (rc ! = 剛工〇 _ SUCCESS) { / * if error */ 

pmmioinfo- > ulErrorRet = rc; / * see IdentifyStorageSystem */ 

ioCleanUp (pninioinfo) ; 
return (MMIO- ERROR) ; 

} 

/ * Allocate menory for plempBuffer which is used when */ 

/ * IOProcReadlnterLeaved is called . */ 
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if (ENTERCRIT(rc) ) { 



ioCleanUp(prtimioinfo) ; 
return My[IO- ERROR; 

} 

pinstance- 〉 pTerrpBuffer = HhpAll 〇 cMem(hheap, DEFAULTBUFFERSIZE) ; 
if (pinstance- > pTerrpBuffer = = NULL) { 

EXITCRIT; 

prinmioinfo- > ulErrorRet = MMIOERR. OUTOFMEiyDRY; 
ioCleanUp(pirmioinfo) ; 
return MMIO. ERROR; 

} 

EXITCRIT; 

pinstance- 〉 ulTertpBuff erSize = DEFAULTBUFFERSIZE; 

} 

pinstance- > lFileCurrentPosition = 0; 

pinstance- > hrtimioFileHandle = rtimioCpen (pszFileName, &L 〇 calmmi 〇 inf 〇， 
Localmmioinfo jjlFlags) ; 

if (pinstance- > hmiiioFileHandle < = (HMMIO) 〇 L) / * Test file open error . */ 
rc= Localrrmioinfo ulErrorRet; 
else { 

/ * Call file format specific open routine */ 
rc= ffOpenWrite (prnmioinfo, pinstance) ; 

if (rc = = 0) { 

if ( ! (prrmioinfo 〉 ulFlags & lyiMIO- CREATE) ) { 
rc= ioAddTracksToMovieHeader (pinstance) ; 

if rc = = 0 ) { 

/ * Set lLogicalFilePos to a position pass the header */ 

/ * block to allow read occurring at the first byte */ 

/ * of non-header data . */ 

lFilePosition = f fSeekToDataBegin (pmmioinfo^ pinstance) ; 
if ( lFilePosition < MMIO. SUCCESS) rc = miO . ERROR; 
else pinstance- > lFileCurrentPosition = lFilePosition; 



if (rc ! =0) { 



pmmioinfo- > ulErrorRet = rc; 
ioCleanUp (prnrnioinf o) ; 
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return MV [ 工 〇 - ERROR; 



Set 



the pathname in the instance structure */ 



if (strlen(pszFileName) < CCHMAXPATH) { 

strcpy ( (PSZ) & (p instance- > szFileName ) , pszFileName) ; 
if ( (pinstance- > szFileName) [1 ]==':' ) 

pinstance- > ulEditFlags I = FULLY. QUALIFIED. PATH; 



# endif 



return MMIO. SUCCESS; 



□ 4-17 IOOPEN .C 



4 5 12 □ □ CODEC □ □ 

□ □□□ FOURCC, □□□□□□□□□□ CODEC □□□□□ 4-18 □□□ ioDe 
termineCodec □□,□□□□□□□ CODEC] □□□□□□□□□，□□□□□□□□ 

□ □ CODEC □ □；□□，□□□ MMPMMMIO. INI □□,□□□□□□□ CODEC[] □ 

□ □□□□□□□□□□□ FOURCCm □□□□□□□□□□□□□□□□□□□□ 

□ CODEC,[] □□□□□ MMPMMMIO. ■□□，□□□□□□□□□□□□□□□□ 

□ □ INI □□□□□□ □ CODEC □□□□□□□ FOURCC □□,□□□□□□□□ 
CODEC □,□□□□□□ CODEC：] ULIOT □□□ ULGDAT .(：□□□□□□□□□□ 
CODEC □(□□ 4-19[] )□□□□ IOProc[] □□□，□□□□□□□ CODEC □□ □ 



LONG ioDetermineCodec ( PINSTANCE pinstance, 

ULQNG ulSearchFlags, 
PCODECINIFILEINFO pcifi) 



LONG 


rc = 剛工〇 - 


SUCCESS; / 


氺 


Return code of IOProcs call 


*/ 


USHORT 


i ； 


/ 


氺 


Loop index 


*/ 


ULONG 


ulFlags; 










HPS 


hps; 


/ 


氺 


Use to query color support 


*/ 


HAB 


hab; 


/ 


氺 


anchor block 


*/ 


HM2 


hmq; 


/ 


氺 


anchor block 


*/ 



if (pcifi- > ulCapsFlags & CODEC. DECOMPRESS) { 

/ * Query the display mode */ 

if (ulNumColors = = 0) { / * Get this info once per process */ 

hab = Winlnitialize (0 ) ; 
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// hmq= WinCreateMsgQueue (hab, 〇L) ; 

hps = WinGetPS (HWND. DESKTOP) ; 
DevQueryCaps ( GpiQueryDevice (hps) A 
CAPS. COLORS, 

1L, 

(PLONG) &ulNumColors) ; 
WinReleasePS (hps) ; 

// WinDestroyMsgQueue (hmq) ; 

WinTermi nate (hab) ; 



/ * Set the color depth for the CODEC we want */ 
if (ulNumColors = = 16) 

pcifi- > ulCapsFlags I = CODEC- 4- BIT- COLOR; 
else if (ulNumColors > 256) 

pcifi - > ulCapsFlags I = CODEC. 16. BIT. COLOR; 
else / * 256 and anything else */ 

pcifi- > ulCapsFlags I = CODEC- 8- BIT- COLOR; 

} 

/ * Search for the DEFAULT codec of this type from the MMIO INI file */ 

pcifi- > ulCapsFlags I = CODEC. DEFAULT; / * Pick default */ 
ulFlags = ulSearchFlags I 

MV [工 〇_ MATCHFOURCC I 
應工〇_ MATCHCCMPRESSTYPE I 
MMIO- MATCHCAPS FLAGS I 
剛工〇- MATCHFIRST I 
MMI〇_ FIM3PROC; 



if ( ! (rc = mmi〇IniFileC〇DEC(pcifi, ulFlags) ) ) { 
return (MMIO. SUCCESS); 

} 

/ * If no default, find first one and use it from the MMIO INI file */ 

pcifi- > ulCapsFlags & = CODEC. DEFAULT; 
ulFlags = ulSearchFlags I 

MMIO- MATCHFOURCC I 
剛工〇_ MATCHCOMPRESSTYPE I 
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MMIO- MATCHCAPS FLAGS I 



剛工〇- MATCHFIRST I 
MMI〇_ FINDPROC; 

' * Match the fourcc, compress type, caps flags */ 
if ( ! (rc = mmi〇IniFileC〇DEC(pcif i, ulFlags) ) ) { 
return (應工〇_ SUCCESS); 

} 

' * Search any internal CODEC tables for the necessary CODEC to load . */ 
' * Note: This is used for debugging new CODEC! S that have not been */ 
' * added to the lyMPMyiMIO .INI file . */ 

for (i = 0 ； i< NUMBER- CODEC- TABLE; i + + ) { 

if ( (acifiTable[i] .ulCorrp ressType = = pcifi- > ulCorrpressType) & & 
( (acifiTable [i] ulCapsFlags & pcifi- > ulCapsFlags) 

== pcifi- 〉 ulCaps Flags ) ) { 

* pcifi = acifiTable[i] ; / * Copy contents */ 

return (MMIO. SUCCESS) ; 

} 

} 

return (MMIOERR. CODEC. NOT. SUPPORTED); 



G 4-18 ioDetermineCode (IOCODEC .C) 



□ 4-19 □□□□□ MMPMMMIO .INI □□□□□□□ CODEC □□，□□□□ □ 
IOProc □□ CODEC INI □□□□□□□□□□ 



CODECINIFILEINFO acifiTable[] = { 

{ 

sizeof (CODECINIFILEINFO) , 

FOURCC- FFIO, 

’’ULBDC4 ”， 

/ * szDCIODLLName [] -Decorrpression IOProc DLL name */ 

〃 CodecEntr/ , 

/ * szDCIOProcName [ ]-Decomp IOProc entry pt proc name */ 
UM. VIDEO. COMPRESSION. TYPE- BH146, 

/ * ulDecompressionType-ID of each decompression type */ 
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〇L, 



應工〇_ MEDIATYPE_ DIGITALVIDEO, 



CODEC. DECOMPRESS + 

CODEC. SELFHEAL + 

CODEC. ORIGIN- UPPERLEFT + 
CODEC. 4. BIT. COLOR, 



* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 



〇, 

〇, 

〇, 

〇, 

〇, 



〇, 



sizeof (CODECINIFILEINFO) , 

FOURCC- FFI〇， 

"ULBDC8” ， 

/ * szDCIODLLName [] -Decorrpression IOProc DLL name */ 

" CodecEntr / , 

/ * szDCIOProcName [] -Decorrp IOProc entry pt proc name */ 
UM- VIDEO- COMPRESSION- TYPE - BH146, 



/ * ulDecompressionType- ID of each decompression type */ 

〇L, 

剛工〇_ MEDIATYPE_ DIGITALVIDEO, 



CODEC- DECOMPRESS + 

CODEC- SELFHEAL + 

CODEC. ORIGIN- UPPERLEFT + 
CODEC . MaLAPERTURE + 
CODEC. DIRECT. DISPLAY. 
CODEC. 8. BIT. COLOR, 

〇, 

〇, 

〇, 

〇, 

〇, 

8 , 

8 , 

〇, 



* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 

* ulCapsFlags- Capabilities Flag */ 
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sizeof (CODECINIFILEINFO) , 
FOURCC- FFIO, 

’’ULBDC16 ”， 



/ * szDCIODLLName [] -Decorrpression IOProc DLL name */ 

〃 CodecEntr/ , 

/ * szDCIOProcName [] -Decorrp IOProc entry point proc name */ 

UM- VIDEO. COMPRESSION. TYPE. BH146, 

/ * ulDecompressionType- ID of each decompression type */ 

〇 L, 

MMIO. MEDIATYPE. DIGITALVIDEO, 

CODEC. DECOMPRESS + / * ulCapsFlags- Capabilities Flag */ 

CODEC- SELFHEAL+ / * ulCapsFlags- Capabilities Flag */ 

CODEC- ORIGIN- UPPERLEFT + / * ulCapsFlags- Capabilities Flag */ 

CODEC. DIRECT. DISPLAY + / * ulCapsFlags- Capabilities Flag */ 

CODEC. 16- BIT. COLOR, / * ulCapsFlags- Capabilities Flag */ 

〇 , 

0 , 

0 , 

0 , 

0 , 

8 , 

8 , 

〇 , 



□ 4-19 CODECINIFILEINFO (ULGD AT .C) 

4 5 13 □ □ CODEC □ □ 

□ □ □ □ □ CODEC CODEC DLL □□□□□□□□□□□□□□□ 

CODEC □ □ □ □ 4-20 □□ □ ioLoadCodecDLL □□□□□□ CODEC □□□□□□ □ 

□ DosLoadModule □□□□ DLL, 

□ ffOpenCodec □□□□ CODEC 4-21 □ )□ 

□ DosLoadModule □□□□□□□□□□□ 09 2 PM □□□□□( 09 2 PM 
Reference) □ 〇 〇 

PCCB ioLoadCodecDLL ( PINSTANCE pinstance. 



■ 180 ■ 



PCODECINIFILEINFO pcifi. 






PULONG phCodec ) 



LONG 


rc = NMI 〇 - SUCCESS; 


/ * Return code of IOProc s call 


SZ 


szLoadError [260] ; 


/ * Error returns . */ 


PCCB 


pccbNew; 




PCCB 


pccb; 




HMDDULE 


hmod= 〇 L; 




PMMIOPROC 


pmmioproc; 




ULONG 


hCodec = 〇 L; 





/ * Search if the CCB entry has been created for the passed in 
/ * pszDLLName and pszProcName, if yes, then sets pccb pointer of 
/ * ptracki to that node . (different track may share a same CCB) 

for (pccb = pinstance- > pccbList; pccb; pccb = pccb- > pccbNext) { 

if ( ! striarp (pcifi- > szDLLName, pccb- > cifi .szDLLName) ) { 
hCodec = pccb- > hCodec; 

if ( ! stricmp (pcifi- 〉 szProcName, pccb- > cifi jszProcName) ) { 
/ * Proc entry names match */ 
return (pccb) ; 

} 

} 

} / * end loop */ 



/ * The above searching cannot find the DCIO node; if a same 
/ * DLLName was found, query I 〇 P roc address directly, else load 
/ * module then query J/ 0 address before allocates a new pccb node . 

if ( DosLoadModule ( szLoadErr or f 

(ULONG) sizeof (szLoadError ) r 
pcifi- 〉 szDLLName, 

& hmod) ) { 

/ * Load Error - MMI 〇 ERR_ INVALID- DLLNAME */ 
return (NULL) ; 

} 

if (DosQueryProcAddr (hmod, 

〇 L, 

pcifi- > szProcName, 




(PFN * ) &pmmioproc) ) { 

/ * Query Error. MMI 〇 ERR_ INVALID- PROCEDURENAME */ 
return (NULL) ; 

} 

/ * The above loading and querying was successful; then create a new 
/ * node for the DC 10 .If HhpAllocMem fails A call DosFreeModule to 
/ * free DCIO module before returning error . 

if (ENTERCRIT(rc) ) { 
return (NULL) ; 

} 

pccbNew = (PCCB) HhpAllocMem (hheap, (ULONG) sizeof (CCB) ) ; 

EXITCRIT; 

IF ( ! pccbNew) { 

D 〇 sFreeM 〇 dule(hm 〇 d) ; 

/ * Allocate error- MMIOERR- OUTOFMEMDRY */ 
return (NULL) ; 



/ * Assigns the Decompress IOProc information, which is in record map 
/ * table ^ to the new DCIO node . 

pccbNew^ > cifi = * pcifi; 
pccbNew^ > hmodule = hmod; 
pccbNew^ > pmmioproc = pmmioproc; 
pccbNew^ > hCodec = 〇 L; 
pccbNew^ > ulLastSrcBuf = 〇 L; 
pccbNew^ > ulMiscl = 〇 L; 
pccbMew- > ulMisc2 = 〇 L; 

/ * Adds new node to the beginning of ccb list . 

pccbNew^ > pccbNext = pinstance- > pccbList; 
pinstance- > pccbList = pccbNew; 

* phCodec = hCodec; 
return (pccbNew) ; 
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START OF SPECIFICATIONS 






氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 

氺 



SUBROUTINE NAME: ioLoadCodec 

DESCRIPTIVE NAME; Load a CODEC IOProc and add it the PCCB list 

FUNCTION: This function loads a CODEC IOProc and adds it to the 
linked list of CODECs currently loaded for this movie instance 

NOTES 

ENTRY POINT: ioLoadCodec 

LINKAGE: CALL FAR (00:32) 



INPUT: 



PINSTANCE pinstance 
PTRACKI ptracki 



-Instant structure . 

-Track specific information 



PCODECINIFILEINFO pcifi -CODEC ini file information 



EXIT-NORMAI ； 



pccb 



EXIT- ERROR 



〇 L 



SIDE EFFECTS 






END OF SPECIFICATIONS 






PCCB ioLoadCodec ( PINSTANCE pinstance, 

PTRACKI ptracki, 

PCODECINIFILEINFO pcifi) 

{ 

LONG rc = MMIO. SUCCESS; / * Return code of IOProc s call . */ 

PCCB pccbNew; 

ULONG hCode c = 0 L; 



i f ( pccbNew = i 〇 L 〇 adC 〇 de cDLL (pi nst ance , pcifi, &hCodec) ) { 

/ * Cpen the Codec IOProc and save the hCodec in the pccb structure 




if (rc = ffOpenCodec (pinstance, pccbNew, hCodec, ptracki) ) { 

pinstance- > pccbList = pccbNew* > pccbNext; / * unlink from list 
ioCloseCodec (pccbNew) ; 

pccbNew= NULL; / * return error condition */ 

} 

} 

return (pccbNew) ; 






START OF SPECIFICATIONS 






SUBROUTINE NAME: ioFindCodec 



DESCRIPTIVE NAME: 



FUNCTION: This function finds a corrpressiory decorrpression 
control block for this corrpression type . 

NOTES: None 

ENTRY POINT: ioFindCodec 

LINKAGE: CALL FAR ( 00 : 32 ) 



INPUT 



/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * 

/ * EXIT-NORMM ； 

/ * 

/ * 

/ * EXIT- ERROR 

/ * 

/ * 

/ * 

/ * SIDE EFFECTS 

/ * 

^ 氺氺氺 氺氺氺 氺氺氺 氺氺氺 spec 工 ; p 工 (^\TIQNiS 氺氺氺 氺氺氺 氺氺氺 氺氺氺 

PCCB ioFindCodec ( P INSTANCE pinstance, 

ULONG ulCorrpressType ) 



PIN STANCE pinstance-Movie instance structure 
ULONG ulCorrpres sType-Corrpression type 



pccb 



NULItOL 
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PCCB pccb; 

for (pccb = pinstance- > pccbList; pccb; pccb = pccb- > pccbNext) { 
if (pccl> 〉 cifi .ulConpressType = = ulCorrpressType) 
return (pccb) ; 

} 

return (NULL) ; / * not found */ 



□ 4-20 ioLoadCodecDLL (IOCODEC .C) 

□ 4-21 □□ ffOpenCodec □□□□□□□□□□□□□ CODEC □□□□□□□□ 
□ □□□□□□(□□□□□□□□□□□□□□□□);□□，□□□ MMIO[] □，□ □ 
CODECn 



LONG ffOpenCodec ( PINSTANCE pinstance, 

PCCB pccb, 

ULONG hCodec, 

PTRACKI ptracki) 



LONG 



rc = NDy[IO- SUCCESS; / * Return code of IOProc s call 



PMMVIDEOHEADER 



pmmV ideoH dr ; 



PCODECVIDEOHEADER pcodecvidhdr; 



Video header node . 









Fill in necessary information for DC IOProc . 









/ * Get standard track header */ 
prinmVideoHdr = (PMMVIDEOHEADER) ptracki- > pTr ackHeader ; 
pccb- > codecopen .pControlHdr = NULL; 

// FOR AVI, fill in from CODEC SPECIFIC DATA SECTION OF HEADER ! 
pccb- > codecopen .pOther Info = NULL; 



ENTERCRITX; 






* Create Source Video Header 









if (pcodecvidhdr = (PCODECVIDEOHEADER) HhpAllocMem(hheap, (ULONG) 
size 〇 f (CODECVIDEOHEADER) ) ) { 

pccb- > codecopen pSrcHdr= (P VOID) pcodecvidhdr; 



pcodecvidhdr- 〉 ulStructLen: size 〇 f( CODECVIDEOHEADER) ; 
pcodecvidhdr- > cx = prtimVideoHdr- > ulWidth; 
pcodecvidhdr- > cy = pnimVideoHdr- > ulHeight; 
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pcodecvidhdr- > cPlanes = 1 ; / * Hardcoded */ 

pcodecvidhdr- > cBit Count =16; / * Hardcoded */ 

pcodecvidhdr- > ulColorEncoding= MMIO. COMPRESSED; / * Hardcoded */ 



/ * Create Destination Video Header */ 

if (pco decvidhdr = ( PCODEC VIDEOHEAD ER) HhpMl 〇 cMem(hheap, 
sizeof (CODECVIDEOHEADER) ) ) { 

pccb- > codecopen .pDstHdr= (PVOID) pcodecvidhdr; 



pcodecvidhdr- > ulStructLen: sizeof (CODECVIDEOHEADER) ; 
pcodecvidhdr- > cx = pnnmVideoHdr- > ulWidth; 
pcodecvidhdr- > cy = prtimVideoHdr- > ulHeight; 
pcodecvidhdr- > cPlanes = 1 ; 

/ * Initialize the Flags and color encoding */ 

pccb- > codecopen .ulFlags = pccb- > cif i ^ilCapsFlags & 
(VALID_ CODECOPEN- INPUTFL AGS); 



/ * Set the color depth for the CODEC we want */ 
if (ulNumColors = =16) { 

pccb- > codecopen ulFlags I = CODEC. 4. BIT. COLOR; 
pcodecvidhdr- > cBit Count =16; 

pcodecvidhdr- > ulColorEncoding = NMIO- PALETTIZED; 

} 

else if (ulNumColors > 256) { 

pccb- > codecopen ulFlags I = CODEC. 16. BIT. COLOR; 
pcodecvidhdr- > cBit Count = 256 ; 

pcodecvidhdr- 〉 ulC 〇 l 〇 rEnc 〇 ding = NMIO- RGB- 5 - 6- 5; 

} 

else { / * 256 and anything else */ 

pccb* > codecopen ulF lags I = CODEC . 8 . BIT . COLOR; 
pcodecvidhdr- > cBit Count = 8 ; 

pcodecvidhdr- 〉 ulColorEncoding = NIMI 〇 - PALETT I ZED ， 



/ 氺氺氺 氺氺氺 氺氺氺 y 

/ * Open the Codec 

/ 氺氺氺 氺氺氺 氺氺氺 y 

rc = pccb- > prrmi 〇 pr 〇 c( &hC 〇 dec, 



(ULONG) 



// Hardcoded */ 
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My[IOM- CODEC- OPEN, 

(LONG) &pcct> > codecopen, 

〇 L) ; 



if ( ! rc) { 

pccb- > hCodec = hCodec; 



EXITCRIT; 
return ( rc) ; 



LONG ffAssociateCodec ( P INSTANCE pinstance, 

PMMEXTENDI1NIF0 pmmextendinfo ) 



LONG 2 ：。 = 剛工〇 _ SUCCESS; 
return ( rc) ; 




□ 小 21 ffOpenCodec (ULCODEC .C) 



4 5 2 □ □ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□： 

1- □ □ □ □ □ CODEC □ □ □ 

2. □ □ CODEC DLL □ □ □ 

3- □□□□□□ CODEC □ □ □ 

4. □ □ CODEC □ □ □ □ □ 

5- □□□□□□ CODEC □ □ □ □ □ □ 

□ 4-22 □□□ IOSET. C □□□□ MMEXTENDINFO □□□□□□□□□□□□ 

□ □□□□□□□ 

□ □：□□□□□□□□□□□ 



^ 氺氺 氺氺氺 氺氺氺 氺氺氺 START OF JSP VERIFICATIONS 氺氺氺 氺氺氺 氺氺氺 氺氺氺 / 

/ * SOURCE FILE NAME : IOSET .C */ 

/ * * / 

/ * DESCRIPTIVE NAME: File Format IOProc routine for MMICM. SET */ 

I * * j 
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/ * COPYRIGHT: 



IBM- International Business Machines 



Copyright (c) IBM Corporation 199 1, 1992, 1993 



All Rights Reserved 



* STATUS: 0^ 2 Release 2 J 〇 



FUNCTION: This source module contains the set functions 
NOTES; 

DEPENDENCIES: none 

RESTRICTIONS: Runs in 32- bit protect mode (0^ 2 2 .0) 



ENTRY POINTS: 



IOProcSet 






END OF SPECIFICATIONS 






# include 



< stdio .h > 



# include 



< string .h > 



# include 



< stdlib .h > 



# include 



< memory .h > 



# define 



INCL. DOS 



/ * # define INCL. DOSPROCESS . */ 



# define 



INCL. ERRORS 



# define 



INCL. WIN 



# define 



INCL. GPI 



# include 



< os2 .h > 



* 0^ 2 headers 



# include 



< pmbitmap h > 



# define 



INCL. 0S2MM 



# define 



INCL. MMIO. CODEC 



# define 



INCL_ MMI 〇 - DOSIOPROC 



# include 



< os2me h > 



Multimedia 10 extensions . */ 



# include 



< hhpheap .h > 



# include 



< ioi h > 






START OF SPECIFICATIONS 






SUBROUTINE NAME: IOProcSet 



DESCRIPTIVE NAME: Set various conditions in IOProc 



FUNCTION: 
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/ 


氺 






*/ 


/ 


氺 


NOTES: None 




*/ 


/ 


氺 






*/ 


/ 


氺 


ENTRY POINT: 


IOProcSet 


*/ 


/ 


氺 






*/ 


/ 


氺 


LINKAGE: 


CALL FAR (00:32) 


*/ 


/ 


氺 






*/ 


/ 


氺 


INPUT: 




*/ 


/ 


氺 


PMMIOINFO 


prrmioinfo-ptr to instance structure 


*/ 


/ 


氺 


LONG 


lParaml- first parameter 


*/ 


/ 


氺 


LONG 


lParam2- Second parameter 


*/ 


/ 


氺 






*/ 


/ 


氺 






*/ 


/ 


氺 


EXIT- NORMAL: 




*/ 


/ 


氺 




剛工〇_ SUCCESS 


*/ 


/ 


氺 






*/ 


/ 


氺 


EXIT- ERROR: 




*/ 


/ 


氺 




MMIO- ERROR 


*/ 


/ 


氺 






*/ 


/ 


氺 


SIDE EFFECTS 


： 


*/ 


/ 


氺 






*/ 


/ 


氺 


****** 


* * * * END OF SPECIFICATIONS * * * * 


*********/ 



LONG IOProcSet ( PMMIOINFO pmmioinfo, 
LONG lParaml , 

LONG lPararri2 ) 



P INSTANCE 


p instance; 


LONG 


rc = MMI〇_ SUCCESS; 


PMMEXTENDINFO 


pmmextendinfo = (PIMMEXTEND INFO) lParaml ; 


PCCB 


pccb; 


ULONG 


ulCCBCount; 


PCODECASSOC 


pcodecassoc; 


ULONG 


ulSize; 


PVOID 


P t rNextAva il ; 


if (rc= i〇GetPtrInstance(pmmi〇inf〇， &pinstance) ) 



return (rc) ; 
switch ( lParam2 ) { 



/ * SET INFO */ 

case MMIO. SET. EXTENDED INFO; / * Set extended information */ 
if (pmmextendinfo) { / * error check */ 
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/ * Set active track */ 

if (pmmextendinfo- > ulFlags & MMIO- TRACK) { 

if (pmmextendinfo > ulTrackID = = (ULONOMMIO. RESETTRACKS) { 
pinstance- > lCurrentTrack = pmmextendinfo- > ulTrackID; 

} 

else { 

if (pinstance- > ulFlags & OPENED. READONLY) { 

if ( ioFindTracki (pinstance, pmmextendinfo- > ulTrackID) ) { 
pinstance- > lCurrentTrack = pmmextendinfo- > ulTrackID; 

} 

else { 

pmmioinfo > ulErrorRet = MyH 〇 ERR- INVALID- PARAMETER; 

rc = MyH 〇 _ ERROR; 

break; 

} 

} 

else if (pinstance- > ulFlags & 

(OPENED. READWRITE I OPENED. WRITECREATE) ) { 
pinstance- > lCurrentTrack = pmmextendinfo- > ulTrackID; 

} 

else { 

prnmioinfo- > ulErrorRet = MyilOERR. INVZ\LID. PARAMETER; 

rc = MMIO. ERROR; 

break; 

} 

} / * else */ 

} / * MMIO. TRACK */ 

/ * Reset all Non. n 〇 2nnal reading modes . All request audio */ 

/ * and video frames are returned . */ 

if (pmmextendinfo- > ulFlags & MMIO. NORMZ^L. READ) { 
pinstance^ 〉 ulMode = MODE- NORMALREAD; 

} / * MMIO. NORMAL. READ */ 

/ * Set IOProc into SCAN mode for the active track . Reading */ 

/ * will now be done, but only Key frames are returned for */ 
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/ * video . */ 

else if (prrmextendinfo > ulF lags & 剛工〇 - SCAN- READ) { 
pin stance- > ulMode = MODE. SCANREAD; 

} / * MMIO. SCAN. READ */ 



* Set IOProc into REVERSE mode for the active track . */ 

氺 Reading will now be done, but only Key frames are */ 

* returned for video */ 



else if (pmmextendinfo > ulFlags & MMIO- REVERSE- READ) { 
pin stance- > ulMode = 1XDDE_ REVERSEREAD; 

} / * MMIO. REVERSE. READ */ 



* Associate CODEC information for recording */ 



if (pmmextendinfo- > ulFlags & My[IO- CODEC. ASSOC) 



/ * Don t alow a CODEC association for read only files */ 
if (pinstance- > ulFlags & OPENED. READONLY) { 

pmmi 〇 info > ulErrorRet = MyilOERR- INVALID - PARAMETER; 

rc = MMIO - ERROR; 

break; 

} 

/ * Can only associate 1 CODEC for record */ 
if (pmmextendinfo- > ulNumCODECs = = 1) { 
if ( rc = ioAssociateCodec (pmmioinfo, 

pinstance, 

pmmextendinfo- > pCODECAssoc) ) { 
pmmioinfo- > ulErrorRet = rc; 
rc = 剛工〇 _ ERROR; 

} 

} 

else { 

prrmioinfo- > ulErrorRet = IMIMIOERR- INVZ^LID. PARAMETER; 
rc = 剛工〇 _ ERROR; 

} 

} / * MMIO. CODEC. ASSOC */ 

} / 氺 pmmexteridedi nf o 氺 / 
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else { / * error-data structure missing */ 

pmmioinf 〇■〉 ulErrorRet = MV [工 〇ERR_ INVALID. PARAMETER; 
rc = MMIO- ERROR; 

} 

break; 

/ * QUERY BASE AND CODEC INFO */ 

case MMIO- QUERY- EXTENDED INFO- ALI； 

/ * Query Also CODEC associated info */ 

/ * Create the array of codecassoc structures to return to caller */ 
pcodecassoc = pmmextendinfo- > pCODECAssoc; / * Point to beginning */ 
for (pccb = pinstance- >pccbList; pccb; pccb = pccb- > pccbNext) { 
pcodecassoo > pCodecOpen = NULL; 
pcodecassoc- > pCCDECIniFilelnfo = NULL; 
pcodecassoc + + ; 



PtrNextAvail = (PVOID) pcodecassoc; 

/ * Fill in pointers to the CODECIniFilelnfo structures to follow */ 
ulSize = 〇L; 

pcodecassoc = pmmextendinfo- > pCODECAssoc: / * Point to beginning */ 
for (pccb = pinstance- > pccbList; pccb; pccb = pccb- > pccbNext) { 

/ * Create and copy CODECINIFILEINFO structure */ 
pcodecassoo >pC〇DECIniFileInf〇= (PCODECINIFILEINFO) PtrNextAvail; 
memcpy (pcodecassoc- > pCODECIniFilelnfo, & pccb- > 
cifi, sizeof (CODECINIFILEINFO) ) ; 

PtrNextAvail = (PVOID) ( ( (ULONG) PtrNextAvail) 

+ sizeof (CODECINIFILEINFO) ) ; 

/ * Create and copy CODECOPEN structure */ 
pcodecassoc- > pCodecCpen = PtrNextAvail ; 
memcpy (pcodecassoc- > pCodecCpen, &pccb- > codecopen, 
sizeof (CODECOPEN) ) ; 

PtrNextAvail = (PVOID) ( ( (ULONG) PtrNextAvail) 

+ sizeof (CODECOPEN) ) ; 



*/ 

*/ 



/ * Create and copy Pointers to structures 
/ * in the CODECOPEN structure . 
if (pccb- > codecopen pControlHdr) { 

ulSize = * ( (PULONG) pccb- > codecopen pControlHdr) ; 

( (PCODECOPEN) pcodecassoc- > pCodecCpen) _> pControlHdr : 
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(PVOID)PtrNextAvail; 

memcpy ( ( (PGODEGOPEN) pcodecassoc- > pCodecOpen) _ > pGontrolHdr, 
pccb- > codecopen .pControlHdr, 
ulSize) ; 

PtrNextAvail = (PVOID) ( ( (ULONG) PtrNextAvail) + ulSize) ; 

} 

if (pccb- > codecopen pSrcHdr) { 

ulSize = * ( (PULONG) pccb- > codecopen pSrcHdr) ; 

( (PCODECOPEN) pcodecassoc- > pCodecCpen) - > pSrcHdr 
= PtrNextAvail; 

memcpy ( ( (PCODECOPEN) pcodecassoc- > pCodecCpen) - > pSrcHdr A 
pccb- > codecopen .pSrcHdr, 
ulSize) ; 

PtrNextAvail = (PVOID) ( ( (ULONG) PtrNextAvail) + ulSize) ; 

} 

if (pccb- > codecopen pDstHdr) { 

ulSize = * ( (PULONG) pccb- > codecopen pDstHdr) ; 

( (PCODECOPEN) pcodecassoc- > pCodecCpen) _> pDstHdr 
= PtrNextAvail; 

memcpy ( ( (PCODECOPEN) pcodecassoc- > pCodecCpen) - > pDstHdr A 
pccb- 〉 codecopen .pDstHdr, 
ulSize) ; 

PtrNextAvail = (PVOID) ( ( (ULONG) PtrNextAvail) + ulSize) ; 

} 

if (pccb- > codecopen pOtherlnfo) { 

ulSize = * ( (PULONG) pccb- > codecopen pOtherlnfo) ; 

( (PCODECOPEN) pcodecassoc- > pCodecCpen) _> pOtherlnfo 
= PtrNe xtAvail ; 

memcpy ( ( (PCODECOPEN) pcodecassoc- > pCodecCpen) - > pOtherlnfo, 
pccb- 〉 codecopen .pOtherlnfo, 
ulSize) ; 

PtrNextAvail = (PVOID) ( ( (ULONG) PtrNextAvail) + ulSize) ; 

} 

pcodecassoc + + ; 



/ * QUERY BASE INFO (NOTE: Fall through 
/ * from previous case !) 

case MMIO. QUERY. EXTENDED INFO. BASE: / * 



*/ 

*/ 

Query only MMEXTEND INFO info */ 
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prrmextendinfo- > ulStructLen= sizeof OyMEXTENDINFO) ; 
pmmextendinfo > ulTrackID= (ULONG)pinstance- > lCur rent Track; 

/ * pmmextendinfo- > pCODECAssoc = NULL; */ 

/ * Corrpute ulBufSize for corrplete information return */ 
ulSize = 〇 L; 

for (pccb = pinstance > pccbList, ulCCBCount = 0; / * Count CCB' S 
pccb; 

ulCCBCount + + r pccb = pccb- > pccbNext) { 
ulSize + = sizeof (CODECASSOC) + si zeof (CODECOPEN) 



+ sizeof (CODECINIFILEINFO) ; 



static stuff 



/ * Extract ulStructLen as first field of structure */ 
/ * that ptr points to . */ 

if (pccb- > codecopen .pControlHdr) { 



ulSize + 



( (PULONG) pccb- > codecopen pControlHdr) ; 



if (pccb- > codecopen .pSrcHdr) 



ulSize + 



( (PULONG) pccb- > codecopen pSrcHdr) ; 



if (pccb- > co decopen .pDstHdr) 



ulSize + 



( (PULONG) pccb- > codecopen pDstHdr) ; 



if (pccb- > codecopen .pOtherlnfo) 



ulSize + 



( (PULONG) pcct> > codecopen pOtherlnfo) ; 



pmmextendinfo > ulNumCODECs = ulCCBCount; 
pmmextendinfo- > ulBuf Size = ulSize; 
break; 






ERROR 






default: 

pmmioinfo 〉 ulError Ret = NMIOERR- INVALID- PARAMETER; 

rc = MMIO - ERROR; 

break; 

}/ * end switch 氺 / 



return ( rc) ; 
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4521 □ CODEC □□□□ □ 

□ 4-23 □□□□□□ □ CODEC □ □□□□(□)□□□ 

LONG i 〇 Ass 〇 ciateC 〇 dec ( PMy [ 工 〇 INF 〇 pmmioinfo, 

P INSTANCE pi nstance, 

PCODECASSOC pcodecassoc ) 

{ 

LONG rc = miO- SUCCESS; / * Return code of IOProc s call . */ 

PCCB pccb; 

ULONG h Codec : / * Possibly returned from ioLoadCodecDLL */ 

/ * Check for NULL pointers */ 

if ( ! pcodecassoo > pCodecOpen I I ! pcodecassoc- > pCODECIniFilelnfo) { 
return (MMIOERR. INVALID. PARAMETER) ; 



/ * Force the correct values into the COD ECINIFILE INFO structure */ 
pcodecassoo > pCODECIniFilelnfo- > ulStructLen = si ze 〇 f (CODECINIFILEINFO) ; 
pcodecassoo > pCODECIniFilelnfo- > fee = pmmioinfo- 〉 fccIOProc; 
pcodecassoc- > pCODECIniFilelnfo- > ulCapsFlags I = CODEC. COMPRESS; 

/ * Find the codec to load */ 

if (rc = ioDetemineCodec (pinstance, 0, pcodecassoo > pCODECIniFilelnfo) ) 

{ 

return (rc) ; / * return error */ 



else { / * load and open the corrpression codec */ 



* Check for previously installed CODECs . */ 

* De- install any loaded . Load new one . */ 

* Allows only 1 CODEC to be loaded at a time . */ 



if (pinstance > pccbList) { 
peeb = pinstance- > pccbList; 

p instance- > pccbList = peeb- > pccbNext; / * unlink from list */ 
ioCloseCodec (peeb) ; 



* Load the codec dll */ 



if (pccb= ioLoadCodecDLL (pin stance ^ 

pcodecassoo > pCODECIniFilelnfo, 
&hCodec) ) { 



* Save the codec open information in the ccb */ 
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( (PCODECOPEN)pcodecassoc- > pCodecOpen)- > ulFlags I = CODEC. COMPRESS; 
* Force open of corrpressor */ 



if ( ! ( rc = io InitCodecopen (pccb, (PCODECOPEN) pc odecassoo > 
pCodecCpen) ) ) { 

/ * Cpen the codec */ 
if ( ! ( rc = pccb- > pmmioproc ( &hCodec, 

MMIOM. CODEC. OPEN, 

(LONG) &pccb- > codecopen, 

〇 L) ) ) { 

pccb- > hCodec = hCodec; / * save handle to codec */ 

} 

} 

/ * handle error conditions */ 
if (rc) { 

pinstance- > pccbList = pccb- > pccbNext; / * unlink from list 
ioCloseCodec (pccb) ; 

} 

} 

else { 

rc = MMIO . ERROR; 

} 



return (rc) ; 



〇 4-23 ioAssociateCodec (IOCODEC .C) 



4522 □□□□□□□ 

□ □□□□ 4-23 □□□ ioAssociateCodec □□□□ iolnitCodecopen □□□□□□ □ 
□ 4-24 □□□ iolnitCodecopen □□□□□□□□□□□□□□□□ CODEC □□ □ 
(CCB)[] □ CODECOPEN □□ □ 

LONG iolnitCodecopen ( PCCB pccb, 

PCODECOPEN pcodecopen) 

{ 

ULONG ulSize; 

ENTERCRITX; 

pcct> > codecopen .ulFlags = pc 〇 dec 〇 pen~ > ulFlags; 
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/ * Create and copy Pointers to structures in CODECOPEN structure */ 
i f ( pcodecop en- > pCont rolHdr ) { 

ulSize= * ( (PULONG) pcodecopen- > pControlHdr) ; 

if ( ! (pccb- > codecopen pControlHdr = (PVOID) HhpAllocMem(hheap f ulSize) ) ) 

{ 

return (MMIO- ERROR) ; 

} 

memcpy(pccb- > codecopen pControlHdr, pcodecopen- > pControlHdr , ulSize) ; 

} 

if (pcodecopen- > pSrcHdr) { 

ulSize = * ( (PULONG) pcodecopen- > pSrcHdr) ; 

if ( ! (pccb- > codecopen pSrcHdr = (PVOID) HhpAllocMem(hheap f ulSize) ) ) 

{ 

return (lyiMIO- ERROR) ; 

} 

memcpy(pccb- > codecopen pSrcHdr A pcodecopen- >pSrcHdr, ulSize) ; 

} 

if (pcodecopen- > pDstHdr) { 

ulSize = * ( (PULONG) pcodecopen- > pDstHdr) ; 

if ( ! (pccb- > codecopen pDstHdr = (PVOID) HhpAllocMem(hheap f ulSize) ) ) 

{ 

return (MMIO- ERROR) ; 

} 

memcpy(pccb- > codecopen pDstHdr f pcodecopen- > pDstHdr A ulSize) ; 

} 

if (pcodecopen- > pOtherlnfo) { 

ulSize = * ( (PULONG) pcodecopen- > pOther Info) ; 

if ( ! (pccb- > codecopen pOtherlnfo = (PVOID) HhpAllocMem(hheap, ulSize) ) ) 

{ 

return (MMIO. ERROR) ; 

} 

memcpy(pccb- > codecopen pOtherlnfo, pcodecopen- > pOtherlnfo f ulSize) ; 

} 

EXITCRIT; 

return (MMIO. SUCCESS); 

〇 4-24 iolnitCodecopen (ULCODEC .C) 
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4 5 2 3 □□ CODEC □ □ 

□ 4-25 □□□□□□□□□ CODEC □□□□□□ ioCloseCodec □□□□□ CODEC 
□ □□□□□ 

LONG ioCloseCodec ( PCCB pccb ) 

{ 

LONG rc = My[IO. SUCCESS; / * Return code of IOProc s call . */ 

ENTERCRITX; 

if (pccb- > co decopen .pSrcHdr) { 

HhpFreeMem ( hheap A (PVOID) pccb* > codecopen pSrcHdr) ; 

} 

if (pccb- > co decopen .pDstHdr) { 

HhpFreeMem (hheap, (PVOID)pccb- > codecopen pDstHdr) ; 

} 

if (pccb- > co decopen .pControlHdr) { 

HhpFreeMem (hheap, (PVOID)pccb- > codecopen pControlHdr) ; 

} 

if (pccb- > codecopen .pOtherlnfo) { 

HhpFreeMem ( hheap, (PV 〇 ID)pccb~ > code copen pOtherlnfo) ; 

} 

if (pccb- > hCodec) { 

rc = pccb- > pmmioproc ( & pccb- > hCodec, 

MMIOM. CODEC. CLOSE, 

〇 L; 

〇 L )； 

if ( ! rc) { 

pccb- > hCodec = 〇 L ; 



if (pccb- > hmodule) { 

// DosFreeModule(pccb- > hmodule) ; 

pccb- > hmodule = 0 ; 

} 

HhpFreeMem (hheap, (PVOID) pccb) ; 
pccb = NULL ; 

EXITCRIT; 

return ( rc) ; 



□ +25 ioCloseCodec (IOCODEC .C) 
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□ sn □ □ □ □ 

□ □□□□□□□□□□□□□□□ (MINSTALL) □□ 0S^2DDDDDDD 
MINSTALL □ : 

■ □□□□□□□□ (MCD) 

■ □ □ □ □ 

□ □□□□□□□□□□□□□□□ DLL □□□□□□□□□ MINSTALL □□ □ 

□ INI □□□ CONFIG SYS 

□ □□□□□□□□□□ MINSTALL □□□□□□□□□□□□□□ MINSTALL 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□ 

□ □□□□□□□□□，□□□□□□□□□ DLL □□(□□□□□□ )□□□□"□□ 

□ □ DLLQ □ T □ □ 

5. 1 □ □ □ □ □ 

MINSTALL □□ (MINSTALL £XE )〇 □□□□□□□□□□□□□□□□□□ 

□ □□□□□□ CONTROL. SCR □□□□□□□□□□□□□□□□□□□□，□□ 

□ □□，□□□□□□□□□□□□□□□□□□□ CONTROL. SCR □□□□□□□□ 

□ MINSTALL □ □□□□□(□□□ 5-1 )□ 

□ □□□□□□□□□ CONTROL. SCR □□□□□□□□□□□□□□□□□□ 
(□□□□□□)□□□□□，□□□□□□□□□□□□□□□□□ MINSTALL. LOG 

CONTROL. SCR □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□，□□□□□□□□□□□□□□□□□□□□□□□□ 

5 J. 1 CONTROL SCR □ □ □ 



□ □ 
□ □ 
□ □ 
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□ 5-1 □□ □ CONTROL SCR \ TOOLKIT \ SAMPES \ 

MM \ CF □ □ □ □ 

/ * control .scr */ 

package =〃 工 BM Multimedia presentation Manager Toolkit/ 2 〃 

codepage =437 

filelist = " f ilelist .tlk 〃 

groupcount = 12 

muni t count = 6 

medianame = "IBM Multimedia presentation Manager Toolkit/ 2 Installation 
Diskette V 

medianaine = "IBM Multimedia presentation Manager Toolkit/ 2 Installation 
Diskette T 



sourcedir = 〃 \ \ 〃 
sourcedir = " \ \ lib \ \ 



destindir = " \ \ mmos2 \ \ 〃 

destindir = " \ \ mmos2 \ \ mmtoolkt \ \ lib \ \ 





□ 5-1 CONTROL. SCR □ □ □ 



□ 5-1 □□□□□□□□□□□□ 



□ 5-1 COMTROL SCR 〇 □ □ □ □ □ 



□ □ □ 
PACKAGE 

CODEPAGE 



□ □□□□□□□□□□□□□□□□□□□□□□□： 

PACKAGE = "IBM Multimedia Presentation Manager Toolkil/ T 

□ □□□□□□□□□□□□□： 



CODEPAGE = 437 

filelist 

FILELIST = "FILELIST .TLIC 
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■ □□□□□□□□□□ ,MINSTALL □□□□□□ DESTINDIR □□□□□□ □ 

□ □ □ □ 

' □□□□□□□□□□□□□□□□□□□□□，□□□□□□ (MEDIA- 
COUNT)Q □ □ □ □ 

■ □□□□□□□□□□□□□□□□□□：□□□□/*□ */□□□□□□□□□ 
□ □□□□□□□□□□□ 

' □□□□□□□□□□□□□，□□□□□□□□□ 

■ □□□□□□□□□□□□□□□□□,□□□□□□□□□ \ D 

1 □ □ \ n □ □ □ 

5 12 CONTROL SCR □□□□ □ 

CONTROL. SCR 



□ □ 



□ □ □ 
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□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 1 


] , 






□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ 


□ 


□ 




□ 


□ 


□ 


□ 


□ 


□ 


























































MEDIANAME ： 


〃 


IBM 


Multimedia 


Presentation 


l Manager 


Toolkit/ 


2 


Installation 




















Diskette 


r 










































SOURCEDIR 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ 


□ 


□ 




□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□，口 


□ 


□ 




□ 


□ 


□ 


□ 


□ 


□ 


〇□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ [ 


] [ 


] I 


: i 


□ 
























SOURCEDIR 


〃 


\ 


\ 


LIB 


\ 


\" 


二 


l 






































DESTINDIR 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ □ 


□ 


□ 




□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


，□ 


□ 




□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


〇□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ [ 


] [ 


] 1 


] i 


□ □ □ 




















DESTINDIR = 


" 


\ 


\ ： 


MMOS 


2 


\ 


\〃 


= 


0 



































□ □□□□□□□□□□ CONTROL. SCR □□□□，□□□□□□□□□: 
□ □□□□□□ MUNITCOUNT □□□□□□□□ MEDIANAME 



□ 

□ 

□ 

□ 

□ 

□ n 

□ n 

□ n 

□ n 

□ n 

□ n 

] □ n 

_ — _ \—/ 

_ R □ 
31 n 
□ JE 

] N n 

□ s r 口 
□ )E 口 



□ 



T 

s 

E 

D 

□ ( n 



□ □ n 

□ □ n 

□ □口 

□ □口 

□ □ n 

□ □ n 
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□□□□□，□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□□□□: 

■□□□□□□ 

■ □ □ □ 

■ □□□□□□□ 

■ □□□□□□□□□□□□□□ 

■ □ □ □ □ INI □ □ □ CONFIG. SYS □□□□□□□□□□□ 

■ DLL □□□□□□□□ 

□ 5-2 □□□ CONTROL. SCR □□□□□□□□□□□ 



=0 



s sgroup 

ssname Toolkit - Base" 

ssversi 〇 n = "0 j63 X)" 
sssize =13 



/ * - 7 = clock */ 

s sgroup =7 

ssname = "Clock Utility" 
ssversi 〇 n = "0 .63 XT 
sssize =839 
s sinich = ’’TLKCLOCK .SCR” 



/ * 

s sgroup 
ssname 
s s vers ion : 
sssize 
s sinich 



- 8 = midiconv */ 

8 

"MIDI File Format Convertef’ 

〃0 .63 XT 

170 

"TLKCONV .SCR" 



/ * - 3 = midiio 氺 / 

s sgroup =3 

ssname = "MIDI I 〇 Procedure" 
ssversi 〇 n = "0 .63 XT 
sssize = 475 



/ * - 11= mcistrng */ 

s sgroup =11 

ssname = "Media Control Interface String Test" 
ssversi 〇 n = "0 .63 XT 
sssize = 194 
s sinich = ’’TLKSTRN .SCR” 
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- 9 = duet 1 */ 



s sgroup 



’Duet Player 工〃 



ssversi 〇 n = "0 j63 XT 



sssize 



4854 



ssinich = "TLKDUTl .SCR 〃 



s sgroup 



- 10 = duet2 */ 



ssname 



Duet Player 工工 



ssversi 〇 n = "0 .63 XT 



sssize 



ssinich = "TLKDUT2 .SCR" 



s sgroup 



- 12 = inc, lib, and h */ 



ssname 



’Header Files, Include Files and Libraries" 



ssversi 〇 n = "0 .63 XT 



sssize 



s sc 〇 nfigch =〃 TOOLKIT .Ctf 



s sgroup 



-13 = prog ref */ 



ssname 



v pr 〇 gram Reference” 



ssversi 〇 n = "0 .63 XT 



sssize 



ssinich = ’’TLKBOOKR .SCR" 



s sgroup 



- 14 = workbook */ 



ssname 



r ’ Workbook" 



ssversi 〇 n = "0 .63 XT 



sssize 



ssinich = ’’TLKBOOKW .SCR 〃 



- 2=avcinst */ 



s sgroup = 2 



ssname 



r， AVC V 0 Procedure Installation Utility 



ssversi 〇 n = "0 .63 XT 



sssize 



ssinich = "TLKIOPU .SCR 〃 
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-4 = caseconv 



s sgroup 



"Case Converter 1 / 0 Procedure" 



ssversi 〇 n = "0 .63 XT 



sssize 



5-2 CONTROL .SCR □ □□□□□□ 



CONTROL .SCR □□□□□□□□□□□□□□ 5-2 〇 



□ CONTROL SCR □□□□□□□□□□ 



□ □ □ 



SSGROUP 



SSNAME 



SSVERSION 



SSSIZE 



SSINICH 



SSCONFIGCH 



SSCOREQS 




□ □□,□□□□□□□□□□□□□□□□□□□□□□□□ ( 〇 -49)D □ 

□ ,□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□： 

SSGROUP =5 

□ ASCIID □□,□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□: 

SSNAME = 〃CD Audio" 

□ □□□□□□□□□□□□□□□□□□□□□ "dd .dd .dd"(dd 〇 □□□ ) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□■□□□□□□□□□□□□□□□□□□□□□□□□□□□□： 
SSSIZE = 〃1 .1 .(T 

□ □□□□□□□□□□□□□□□□□□□ (500 = 500KB )〇 □□□□ □ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□,□□□□□ 
□□□□□□□□： 

SSSIZE = 1024 

□ □□INI □□□□□□□□□□□□□□□□□□□□□,□□□□□ 
INI □ □ □ □ □ ： 

SSINICH = "ACPAINI .CH 〃 

□ □ □ CONFIG.SYS □□□□□□□□□□□□□□□□□□□□□,□□ 

□ □ □ CONFIG.SYS □□□□□： 

SSCONFIGCH = "ACPACON .OT 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□a adddd bddddddd,dd bdddd 

□,□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□: 

SSCOREQS = 1 
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SSICON 



SSDLL 



SSDLLENTRY 



SSTERMDLL 



SSTERMDLLENTRY 



SSDLLINPUTPARMS 



SSSELECT 



□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□, 
□ □□□□□□□□□□： 

SSICON =〃ACPA JCCT 

□ □□□□□□□□ DLL □□□□□□□□□□□□□□□□□□□□□, 

□ □□□□□□□□□□□□□□□□□□,□ SSDLLENTRY □□□□ □ 

□ □ □ □ ： 

SSDLL = " MY DLL" 

□ □□□□□□□□□□□□ SSDLL □□□□□□□□□□,□ SSDLL □ 

□ □□□□□□□： 

SSDLLENTRY = "MyEntry" 

□ □□□□□□□□ DLL □□□□□□□□□□□□□□□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□,□ SSTERMDLLENTRY □ □□□□□□□： 

SSTERMDLL ="MyTERM DLL" 

□ □□□ SSTERMDLL □□□□□□□□□□□□□□□□□□□□□□ 

□ □□□,□ SSTERMDLL □□□□□□□□□: 

SSTERMDLL =" MyTermEntry" 

□ □□□□□□□□□□□ DLLO □□□□□□□□□□□□□ DLL 〇 □ 

□ □□□ SSDLL □ SSTERMDLL □□□□□□□□: 

SSDLLINPUTPRAMS = "5, FILE _NAM, 1 .1 .(T 
□□□□□□□□□□□□□□□ 5DDQ 

"ALWAYS" □□□□□□□□□□□□□□ 〇 □□□□□□□□□□ 

□ □□□□□□□□□□□ 

"REQUIRED" □□□□□□□□□□□□□□□□□,□□□□□□□□ 
"VERSION^ 

"Yes" □□□□□□□□□□□□□□□□□□□□□□□□□ 

□□□□，□□□□□□□□□ 

"N(f 

"BASENEWER" □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□ 

"ONLYNEWER" □□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□ 
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5.2 □□□□□□ 

□ □ □ □ □ CONTROL. SCR □□ FILELIST □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□，□□□□□□□： 

■ □ □ □ 

' □□□□□□□□□□□ 

' □□□□□□□□□□□□ 

■ □□□□□□□ 

□ 5-3 □□□□□□□□□□□□(□□□□□□□□□□ )□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□： 145〇 




* All files on the install disks are listed below . Other information 

* is also given, as follows: 



/ * Disk# 

/ * 

/ * 

/ * 

/ * Group # 



-The number of the disk on which the file resides . 
(Ignored if installing from CD-ROM) r These are sorted 
from 0 to the number of disks, ascending . 

-The logical group to which the file belongs . Group 
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starts at 0 . 



* Dest # -The destination subdirectory into which the file will 

* copied . Dest # starts at 0 . 



* Source # -The source subdirectory from which the file will be 

* copied . 



* FileName - The base filename 

* sourcedir = 〃 \ \ 〃 

* sourcedir = " \ \ lib \ \ " 

* sourcedir = " \ \ h \ \ " 



* sourcedir ： 



\ clock \ \ " 



* sourcedir = " \ \ duetl \ \’ 

* sourcedir = " \ \ duet2 \ \’ 



* sourcedir ： 

* sourcedir ： 



\ mcistrng \ \ " 
\ inc \ \ " 



* sourcedir = " \ \ book \ \ 〃 

* sourcedir = " \ \ cdmct \ \〃 

* sourcedir = " \ \ avcinst \ \ " 



* sourcedir ： 



\ caseconv \ \ f, 



dest indir = " \ \ mmos2 \ \ " 

dest indir = " \ \ mmos2 \ \ mmtoolkt \ \ lib \ \ " 
dest indir = " \ \ mmos2 \ \ rrmtoolkt \ \ h \ \ " 



dest indir : 



mmos2 \ \ install \ \ 



* dest indir = " \ \ mmos2 \ \ mmtoolkt \ \ sairples \ \ clock \ \ 

* dest indir = " \ \ mmos2 \ \ mmtoolkt \ \ sairples \ \ duetl \ \ 



dest indir : 
dest indir : 
dest indir : 



dest indir : 



mmos2 \ \ mmtoolkt \ \ sarrples \ \ duet2 \ \ " 

mmos2 \ \ mmtoolkt \ \ sairples \ \ mcistrng \ \ " 

mmos2 \ \ mmtoolkt \ \ sairples \ \ cf \ \ " 

mmos2 \ \ mmtoolkt \ \ inc \ \ " 



* dest indir = " \ \ mmos2 \ \ dll \ \ 



dest indir : 



mmos2 \ \ help \ \ 



dest indir = " \ \ mmos2 \ \ mmtoolkt \ 



dest indir : 
dest indir : 



mmos2 \ \ rrmtoolkt \ 
mmos2 \ \ mmtoolkt \ 



dest indir = " \ \ mmos2 \ \ rrmtoolkt \ 



sairples \ \ book \ \ " 
sairples \ \ cdmct \ \” 
sairples \ \ avcinst \ \ " 
sairples \ \ caseconv \ \ " 



groups 



-2 = AVC V 0 Procedure Installation Utility 



*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 
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-3 = MIDI 10 Procedure 



氺 



氺 



氺 



氺 



氺 



氺 



氺 



氺 



氺 



-4 



= Case Converter 0 Procedure 



-7 = Clock Utility 
-9 = Duet Player I 
- 10 = Duet Player 1 1 
- 11 = MCI String Test 

- 12 = Header Files, Include Files and Libraries 
- 13 = Program Reference 
- 14 = Workbook 



* Disk # Group Dest # Source # FileName 



*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 






mmtoolkt \ sanples \ cf 9 14 k */ 



0 


0 


12 


0 


’’CONTROL SClf 


0 


0 


12 


0 


"filelist .tlk" 


0 


0 


12 


0 


’’TLKCLOCK .SCR” 


0 


0 


12 


0 


’’TLKIOPU SClf 


0 


0 


12 


0 


"TLKCONV SClf 



0 0 4 
0 0 4 
0 0 4 
0 0 4 



0 ’’TLKCLOCK SCR” 

0 ’’TLKIOPU .SCR” 

0 ’’TLKCONV .SCR” 

0 "tlkstrn .scr" 



0 


10 


12 


0 


’’TOOLKIT Of 






mmtoolkt \ 


inc 10 83 k 


0 


12 


13 


13 


〃ACB .INC" 


0 


12 


13 


13 


’’AUDIO JNCf 


0 


12 


13 


13 


〃DCB .INC" 



*/ 



mmtoolkt \ lib 11 5 〇 K */ 

0 12 1 1 ’’AUDCTL 11^ 

0 12 1 1 "DSPMGRDL ilB" 
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• 


0 


12 


1 


i 


"LVDP8000 iIB 〃 






/ * 






mmtoolkt \ h 


22 269k 




*/ 




0 


12 


2 


2 


"ACB ii' 








0 


12 


2 


2 


’’AUDCTL if 






• 


0 


12 


2 


2 


’’AUDIO 






/ * 






mmtoolkt \ sairples \ duet 2 


12 390k 


*/ 




0 


10 


10 


10 


"duet2 «c 〃 








0 


10 


10 


10 


"duet2 ii” 






• 


0 


10 


10 


10 


"duet2 rc 〃 






/ * 






rrmtoolkt \ sairples \ avcinst 


9 102K 


*/ 




0 


2 


18 


18 


"avcinst .dig" 








0 


2 


18 


18 


’’avcinst .def’ 






• 


0 


2 


18 


18 


’’avcinst .ipf’ 






/ * 






mmtoolkt \ sairples \ caseconv 


8 72k 


*/ 




0 


4 


19 


19 


’’convcvsr .c" 








0 


4 


19 


19 


’’convproc .re" 






• 


0 


4 


19 


19 


"convconv .c 〃 






/ * 






mmtoolkt \ sairples \ midi con v 


2 44K 


*/ 




1 


8 


15 


0 


〃 midic 〇 nv *hlp 〃 








1 


8 


0 


0 


r， midiconv axe" 






/ * 






mmtoolkt \ sairples \ racist rng 


14 194K 


*/ 




1 


11 


ii 


11 


"mcistrng <c 〃 








1 


11 


ii 


11 


"mcistrng h” 






• 


1 


11 


ii 


11 


"mcistrng xc 〃 







□ 5-3 □□□□□□ 
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□ 5-3 □□□□□□□□□□□□□ 



□ 5-3 □□□□□□□□□□ 



Media# 



Group 口 
Subsystem # 



□ □□□□□□□□□□(□□□□□□)□□□□□□□ 〇□□□□,□□□□□ 
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□a 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□(□□□□ CON- 
TROL. SCR □ □ □ □ □ SSGROUP □□□□),□□□□□□□□□□□□□□□ 



Destination # 



Source # 



File name 



□ □ □ □ 

□ □□□□□□□□□□□□□□□□ CONTROL. SCR □□□□□ DESTINDIR 

□ □□□□□□□□□□□□□□□□(□□, 14 □□□□ \ MMOS2 \ DLL)D 

□ □□□□□□□□□□□ CONTROL. SCR □ □ □ □ □ SOURCEDIR □ □ □ □ □ 

□ □□□□□□□□□□□(□□,!□□□□ \ LIB)D 

□ □□□□□,□□□□□□□□□□□□□□ "MINSTALL £XE "〇 



5.3 □□□□□□ 

□ □□□□□□□□□ CONFIG. SYSDDD INI □□□□□□□□□□□□□□ 
□ SSCONFIGCH □ SSINICH □□□□□□□□□□□□□□□ 

5 3 1 □ □ □ 



□□□□□□□□□□□□□□□□□□□□□□□□□： 

■ □□□□□□□□□□ 

■ □□□□□□□□□□□□□□ 

■ □ □ CONTROL. SCR □□□□□□□□□□□□□□□□□□ 

' □□□□□□□□□□□□□□□ 

■ □□□□□□□ 

□ 5-4 □□□□□□□□□□ 



□ 5-4 □ □ □ □ □ 



□ 


□ □ 


destindir = 


□ □ (DELETE)O □□□□□□□□□□ DESTINDIR □□□□ □ 


"□ (DELETE) \ \ PATH \\ " 




= number 


□ 


□ (DEST) filename 


□ □ (DEST)D □□□□□□□□□□□□□□□□： 

□ (DEST) CLOCK EXE □ □ 

D: \ MMOS2 \ MMTOOLKT \ SAMPLES \ CLOCK \ CLOCK .EXE 
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□ (DRIVE) 



□ (DIR)# 



□ (BOOT) 



□ □ (DRIVE)D □□□□□□□□□□□□□□□(□□□□□□ 

□ □□□□□)□□□： 

□ (DRIVE) \ MMOS2 \ TEST1 .EXE □ □ 

D \ MMOS2 \ TEST1 EXE 

# □ CONTROL. SCR □□□□□□□□□□□□□□□□□□□ 

□ □□□□□ DESTINDIR □□□□□□□□□□□□□□□□： 

□ (DIR) 4 \ MINSTALL LOG □ □ 

D \ MMOS2 \ INSTALL \ MINSTALL .LOG 

□ □□□□□□□□□□□□□(□□□□□□□□□□□)□□： 

□ (BOOT) \ OS2 \ NEW .SYS □ □ 

C \ OS2 \ NEW .SYS □□0□□□□ O 没 ！□□□□□□□ 



5.3.2 CONFIG. SYSD □□□□ □ 

□ □□□□□□□□□□ CONFIG. SYS □□□□□□□□ CONFIG. SYS □□□ □ 

□ □□□□□□□□□□□□□□□□□□□□ CONFIG. SYS □□□□□□□□□□□ 

□ □ □ SSCONFIGCH □□□□□□□□□□□□□□ 

□ 5-5 □□□□□ CONFIG. SYS □□□□□□□□□□□□□ 



□ □ □ 



S5 CONFIG. SYS □ □ □ 




CONFIG. SYSD 



DEVICE = "□ (DEST)DEVICE .SYS^ parameters” 

□ □□□□□，□□□□□□ (DEST)O □□□□□□□ (DEST )〇 , MINSTALL □ □ 

□ □□□□□□□ DEVICE. SYSQ □□□□□□□□□,□ (DEST)D □□□□□□ 

□ □□□,□□□□□□□□□□ CONFIG. SYS □□□□□□ : 

DEVICE = "D \ SOMEDIR \ DEVICE SYS parameters" 

□ □ □ □ □ CONFIG. SYS □□□□□□□□□□□□ : 

MERGE "LIBPATH" = 1 

□ 1 □□ CONTROL. SCR □□□□□□□□□□□□□□□ MIN ST ALL 〇 □□□ □ 

□ □，□□□□□□□□□□□ LIBPATH □□□(□□□□□□，□□□□□□□□ 

□ ,□□□□□□□□□□)□□□□□□ LIBPATHQ □,□□□□□□□□□□□ 

MERGE "SOMEVAR" = "WHOKNOWS" 

□ □□□ "SOMEVAR "〇 □□□,□ "WHOKNOWS^O □□□□□□□□□□□□□□, 
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□ □ □ : SOMEYAR = WHOKNOWSD □ □ □ CONFIG. SYS □ □ □ □ 

□ □ : □ □ \ TOOLKIT \ SAMPLES \ MM \ CF □□□ □ TOOLKIT. CH □□ □ 

□ □□□□□□" SET，，。 □□□□□□□□□□□□□□□□□ CONFIG. SYS □ □ 

□ SET"D □□□□□□□□□□□□□ ：SETU □□□□□□□□ 

□ □□□□□： 

MERGE "SET SOMEVAR" = "WHOKNOWS" 

REPLACE □□□□□□ CONFIG. SYS □□□ REPLACE □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□： 

REPLACE "SET MMBASE' = 0 

□ □□□□ CONFIG.SYS 

□ □ □ ： 

SET MMBASE = C \ MMOS2 ; 

533 ■_□□□□□ 

INI □□□□□□□□□□□□□□□： 

' □□□□□□□□□□□□□□ 

■ □ □ MMPM2. INI □□□□□□□□ 

■ □□□□ INI □□□□□□□□ 

5331 □□□□□□□□□□□□ 

□ □□□□□ WPObject □□□□□□□□□□□□□□□□□□□□□□□ 
WPObject □□□ 09 2 WinCreateObject □□,□□□□□□□□□□□□□□□□□□ 

□ □ □ 

□ 5-4 □□ WPObject □□□□□□□□□ 



WPObject = 
( 




WPClassName 


= " WF 〇 lder 〃 


WPTitle 


=" title" 


WPSetupSt ring 


= "IC0NFILE= □ (DEST) icon; OBJECTID = < folderobjid>" 


V\/PLocation 


=〃< parent folderobj id 〉 〃 


V\/PFlags 

) 


= wpflags 



□ 5-4 WPObject Q 

title □□□□□□□□□ 
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CONTROL. SCR □□□□□□□□□□)□ 
icon □□□□□□□□□□□□□ 



icon □□□□□□□□□□□□□□□□ 

< folderobjid > 

□ □□□□□□□□□□□□□□□□ WPObject □ □ □ □ 
WPLocation □□□□□□□□□□ 

< parentfolderobjid > □□□□□□□□□□□□□□□ IDQDDD： /， < WP - 

DESKTOP>"[] □□□□□□□□□□ ID □□ 

WP Flags □□□□□□□□□□□□□□□□□□□□ 

〇 —— 

1 —— □□□□□□□□□ 

2 —— □□□□□□□□□□(□□□□□□□□□□)□ 

□ □□□□□，□□□□ Multimedia Presentation Manager Toolkil/ 

□ □□□□□□ 



WPObject = 




WPClassName 


= 〃 WPF 〇 lder" 


WPTitle 


=" Multimedia Presentation \ nManager Toolkit/ T 


V\7PSetupSt ring 


=" ICONFILE = □ (DEST)MMTOOLKT JCO; OBJECTID = <MMPMTLK >〃 


WPLocation 


=" <WP_ DESKTOP〉” 


WPFlags 

} 


= 2L 


□ □□□□□□ 


WPObject □□□□□□□□□□□□□□□□,□□□□□： 


WPObject = 
/ 




l 

WPClassName 


= "WPPr 〇 gram 〃 


WPTitle 


=" title" 


V\7PSetupSt ring 


= "EXENAME = path file: STARTUPDIR: dir; PROGTYPE = PM; 


ICONFILE 


= □ (DEST) icon; [ASSOCTYPE = type; ] 


[ASSOCFILTER= filter; ] OBJECTID = < pgmobjid> 〃 


WPLocation 


="< parent folderobj id > " 


VJPFlags 

) 


= wpflags 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 



n 

# 

n 

n 

/IV 

n 

n 

# 

R 

I 

D 



□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

□ E 

□ E 

□ . 

□ □ 
□ □ 



n 

n 

n 

□ n 

□ n 

□ 

□ n 

□ n 

□ n 

□ n 
E n 

E n 

. n 

□ n 

□ n 



e *"^ 

tl lt le r 

tit pa m di 
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type □□□□□□□□□□□,□" waveform"[] □□□□□ □口 

□ □ □ □ 

filter □□□□□□□□□□□□□□□ ,U * 蕭”口 □□□ □ 

□ □□□□□□ 

< pgmobjid > □□ 〇 s^2DDDDDDDDDDDDDD IDQDDDD 

□ □□□□□□□□□□□□□□□□ WP Object □ □ □ 
WPLocation □□□□□□□□□ 

< parentfolderobjid > □□□□□□□□□□□□□□□□□□□□ 

〇 —— □□□□，□□□□□□ 

1 —— □□□□□，□□□□□□ 

2 —— □□□□□，□□□□□(□□□□□□□□□□)□ 



JoinEA 5-5 □□□ JoinEA □□□□□□□□ EA □□□□□□□□□□□□□□ 

□ □□□□□□□ WPObject □□□□□，□□□□□□□□□□□ 



JoinEA = 
/ 




\ 

JoinFileName = 


=" full path to file” 


JoinEAFileName = 

) 


= "full path t 〇 EA file" 



〇 5-5 JoinEA □ 



full path to file □□□□□□□，□□□□□□□ 

full path to EA 〇 n EA 



JoinLongNameEA[] :□ 5-6 □□□ JoinLongNameEA □□□□□□□□□□□□□□ 

□ 8DDDDDDDDDDDDDDDDDDDDDD 

(longname) □□□£△□□□□□□□□□□□□□□□□□□□□□□□□□,□□ 

□ □□□□□□□□□□□□□□□□□□□ 



JoinLongNameEA = 
( 




JoinLongN ame : 


=" longname” 


JoinLongF ileName : 


= 〃full pdth t 〇 dirBCtory# 


JoinEALongFileName : 

| 1 


=〃 full path t 〇 EA f ile 〃 



□ 5-6 JoinLongNameEA □ 

longname □□□□□□□□□ (longname) □ 
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full path to directory 
full path to EA file 



□ □□□□□□，□□□□□□□□ 

□ □ ea 



□ □□□□□ JoinLongNameEA □□□，□□ 〇 ^2 〇〇〇〇〇〇〇〇〇〇 (Long- 
Name)[] □□□□□" Sound Bites〃[] □□□□ CONTROL. SCR □□□□□□□ □" 9 "口 
□ □□□□□" 9 "〇 []' Sounds^ □ □ 



JoinLongNameEA = 
( 




\ 

JoinLongN ame : 


=" Sound Bites” 


JoinLongF ileName : 


=〃□ (dir)9" 


JoinEALongFileName : 

1 ) 


="□ (DRIVE )： \ \ MM0S2 \ \ INSTALL \\ sounds .eas" 



□ □□□□□□□，□□□□ MINSTALL □□□□□□，□□□□□□□□□ 

□ (DEST) □□□□□□□□□□ \ MMOS2 \ INSTALL □□□□，□□ 

□ □□□□□□ 

5 3 3 2 □ □ MMPM2. INI □ □ □ □ □ □ 

□ □□□□□□□□ MMPM2. INI □□□□□□□□□□□□□□□□□ (MDM) 

□ □□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□ MMPM2. INI □ □ □ 

McilnstallDrv 5-7 □□□□□□□□□□□□□ MCD 〇 



McilnstallDrv = 



DrvInstallName 


= "internalname” 


DrvDev iceType 


= devicetypecode 


DrvDeviceFlag 


= deviceflag 


DrvVer sionNurribe r 


〃 〃 
= verno 


DrvProductlnfo 


" r \" 

= namez 


DrvMCD Driver 


= ’’mcdname" 


DrvVSD Driver 


= "vsdname” 


DrvPDDName 


= "pddname” 


DrvMCD Table 


= "mcdtablename” 


DrvVSD Table 


= "vsdtablename” 


DrvSha reType 


= number 1 


DrvRes ourceName 


= "resname” 


DrvRes ourceUnit s 


= nurriber2 


DrvClassArray [num] = 





(DrvClassNumber = number 3) 
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□ 5-7 McilnstallDrv [] 



internalname □□□□□□□□□□□□□□□□□□□□□,□□□□□□[□ 

□ □□□□□□□□□□□□, IBM □□□□□□□□□□□□□ 
D D D D ibrnwavesbOlQ 

devicetypecode □□□□□□□□□□□□□□□□□ \ TOOLKIT \ H □□□ □ 

□ MCIOS2.HD □ □ □ □ 

de viceflag □□□□□□□□□□□ LONG INT ，□ □□□□□□□□□□□ 

□ □ 

verno □" dd .dd .dd’’[] □□□□□□□□□ (!(!□□□□□ 

name2 □□□□□□，□□□□□□ 

mcdname □ □ □ MCD □ □ □ DLL □ □ □ □ □ MCD □ MDM □ □ □ (MCD— 

□ □□□□□□) 

vsdname □ □ □ VSD([] □□□□□□)□□□ DLL □□□□ □ 

pddname □□ MCD □□□□□□□□□□□□□ 

mcdtablename □□□ MCD □□□□□□ DLL □□□ (09 

□ )□ 

vsdtablename □ □ □ VSD □□□□□□ DLL □ □ □ □ 

numberl □□□□□□□□□□□□□□□□□ \ TOOLKIT \ H □□□ □ 

□ MMDRV0S2. H □ □ □ □ □ 
resname □□□□□□□□□□□□□□□□ 

number2 □□□□□□□□□ 

num □□□□□□□□□□□□□□□□ 

number3 □□□□□□□□□□□□□□ 

McilnstallAlias □ : 

□ 5-8 □□□□□□□□□□□□□□□□□□□□ 

McilnstallAlias = 

( 

AliasInstallName =" internalname” 

AliasString = aliasstring 

I ) I 

□ 5-8 McilnstallAlias Q 

internalname □□□□□□□□□□□□□ McilnstallDrv □□□□□□ 
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alias string □□□□□□□□□□ 

McilnstallConnD :□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□，□□□□□□□，□□□□□□□□□□□□□□□□□□ 5-9 □□□ Mciln- 
stallConn □□□□□□□□□□□□□□□ 

McilnstallConn = 

( 

ConnlnstallName =" interna lname" 

ConnArray [numl] 

( 

( 

ConnType = num2 

ConnlnstallTo = "connto" 

ConnlndexTo = num3 



Q 5-9 McilnstallConn Q 

iternalname □□□□□□□□□□□□□□□，□□□□□ McilnstallDrv □□ □ 

□ □ □ 

numl □□□□□□□□□□□□ 

num2 □□□□□□□□□□□□ \ TOOLKIT \ H □□□□□ MCIOS2. H 

□ □□□□□ 

connto □□□□□□□□□□□□□□□ 

num3 □□□□□□ connto □□□□□□□□□□□□ 

McilnstallExt MCI-OPEN 

□ □□□□□□□□□□□□,□□ -WAV □□□□□□□□□□□□，□□□□□ 

■ WAV □□□□□□□□□□□□□□□□ 

□ 5-10 □□ McilnstallExt □□□□□□□□□□□□□□□□□□□□□□□ 

McilnstallExt = 

( 

ExtlnstallName = " int ernalname" 

Ext Array [num] = 

( 

(ExtString = 〃 string" ) 



□ 5_ 10 McilnstallExt Q 
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internalname □□□□□□□□□□□□□□□□□□□ McilnstallDrv □□ □ 

□ □ □ 

num □□□ string □ □□□□□□□□□□ 

string □□□□□□□□□□ 



McilnstallParm 5-11 □□□ McilnstallParm □□□□□□□□□□□□□ □□口 

□ □□□□□□□ MCD □□□□□□□□□□□□□□□□, Mcilnstallparm □□□ □ 

□ □ □ □ □ MIDI □□□□□□□□□□□□，□□□□ MIDI MCDQ 



McilnstallParm = 

i 




\ 

PamlnstallName : 
P armString : 

) 


=" internalname” 

device specific parameters' 



□ 5-11 McilnstallParm □ 



internalname □□□□□□□□□□□□□□□□□□□□ McilnstallDrv □ □ 

□ □ □ 

device specific □□□□□□□□□□□□□□□□□□□□□□□□□□□ 
parameters 

5333 □□□□ INI □□□□□□ 

□ □□□□□□□ INI □□□□□□□□□□□□□□□□□□ INI □□□□□, 

□ □□□□□ MIDI 09 2 □ profile □□,□□□□□□□□□□□ ProfileDa" 

ta □□□□□□□□□ 

□ 5- 1 2 □ ProfileData □ □ □ □ □ 

ProfileData = 

( 

ini ="inifilename 〃 
appname = "appname” 
keyname = "keyname” 
dl 1 =〃 resour cedllname" 
id = resourceid 



□ 5-12 ProfileData □ 

inifilename □□ 09 2[] INI □□□□□□: MIDITYPE. INI 口 

appname □□□□□□□□□□□□□□□□ INI □ □ □ 
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keyname □□□□□□□□□□□(□□□□□□□)□ 

resourcedllname □ □ □ □ RCDATA □ □ □ □ DLL □ □ □ □ RCDATA □ □ □ □ ID 

□ resourceid □ □ □ □ 

resourceid □□ RCDATA □□□□ ID □(□□□□□ ID □□ 

□ □□□□□,□□， 12〇 L 〇 

5.4 □ □ □ □ DLL □ □ 

□ □□□□□ DLL[] □□□ DLL □□□□□□□□□□□□□□ 

DLL, □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ DLL □□□ 

■ □□□□□□□□，□□□□□□□□□(□ SSDLL □ SSDLLENTRY □ □ □ □ ) 
□ □ □ DLL □ □ □ 

■ □□□□□□□□，□□□□□□□□□(□ SSTERMDLL □ SSTERMDLLEN- 
TRY 〇 □□□)□□□ DLLQ □ □ 

□ □□□□□□□□□： 

HWND(D □ ) □□□□□□□□ DLL □□□□□□□□□□ 

PSZ(D □ ) □□□□□□□□□□ 

psz(D □ ) 

HWND(D □ ) MINSTALL 

□ CONFIG. SYS □ □ □ 

PSZ(Q □ ) □□□ DLL □□□□□□□□□□□□□□□□□□□□□□ 

DLL □ □ □ □ □ ASCII □□□□□□□□□□□□□□□□□□ 

□ □ , MINSTALL □□□□□□□□□□□□□□□□□□□□ 

□ □ DLL, □ □□□□□□□□□□□ 

G 5-i3[][][][][][][] dll [] D D D D D D D 

ULONG APIENTRY StartMylnstall (HWND hwndOwnerHandle, 

PSZ pszSourcePath, 

PSZ pszTargetDrive, 

PSZ pszMyPams, 

HV\/ND hwndMinstall Handle, 

I PSZ pszResponseFile) ; | 



□ 5-13 □ □ □ □ DLL □ □ 

□ □□□□□, MINSTALL □□□□□ DLL □□□□□□□□□□□□□□□□ 

□ □ minstall, □□□□□□□ OS/2DDDDDD 

□ □□□□□□□ MINSTALL □ □ □ MINSTALL □ □ □ 

MMPM2. INI □□□ CONFIG. SYS □□□□□□□□□□□ MINSTALL □□□□ □ 
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□ □□□□□□ 

□ MINSTALL[] □ MMPM2.INIJ] □□ CONFIG. SYS[] DLL[] □ □ 

□ □□□□□□□□□[□□□□ MINSTALL □□□ DLL □□□□□□□□□□□□□ 

□ os^2DDDDDDDDDDDDD,D minstall □□□□□□□□□□ 

□ , MINSTALL □ □□□□□□□□□□□□□□□□□□ 

□ 5-6 □□□ DLL □□□□□□□□□□□□□□□□, DLL □□ WinSendMsg □ 
WinPostMsg □ □ □ □ □ 

□ 5-6 □ □ DLLD □ □ □ □ 



I M CODEC 1 INSTALL 



□ □ ulCodecCompType □ □ □ □ CODECS 



rrpl = 〇； / * Not used */ 

mp2 = MPFRCMP (PINSTCODECINIFILEINFO) ; / * Pointer to the 

INSTIOPROC structure */ 



IM_ CODEC2INSTALL □ □ fceCodecCompType[5 ]Q □ □ □ CODECQ 

rrpl =0; / * Not used */ 

rrp2 = MPFRCMP (PINSTCODECINIFILEINFO); / * Pointer to the 

INSTIOPROC structure */ 



IM— CONFIGDELETE □□ CONFIG. SYS □□□□□□ □ 

rrpl = MPFRCMP (PCONFIGDATA) ; / * Pointer to the CONFIGDATA structure */ 

mp2 = 0; / * Not used */ 

IM CONFIGENUMERATE □ CONFIG. SYS □□□□□□□ □ 

rrpl = MPFRCMP (PCONFIGDATA) ; / * Pointer to the CONFIGDATA structure */ 

mp2 = 0 ; / * Not used */ 

IM— CONFIGMERGE □□□□□□□□□ CONFIG .SYS □□□ □ 

rrpl = MPFRCMP (PCONFIGDATA) ; / * Pointer to the CONFIGDATA structure */ 

mp2 = 0; / * Not used */ 

IM CONFIGNEW □□□□□□□ CONFIG. SYS □□ □ 

rrpl = MPFRCMP (PCONFIGDATA) ; / * Pointer to the CONFIGDATA structure */ 

rap2 = 0 ; / * Not used */ 
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IM- CONFIGQUERYCHANGED □ CONFIG. SYS □□□□□□□□□□□□: TRUED 

rrpl = 0; / 氺 Not used 氺 / 

rrp2 = 0 ; / * Not used */ 

IM. CONFIGREPLACE □□□□□ CONFIG. SYS □□ □ 

rrpl = MPFROMP (PCONFIGDATA) ; / * Pointer to the CONFIGDATA structure */ 

rrp2 = 0 ; / * Not used */ 

IM. CONFIGUPDATE □□□□□ CONFIG. SYS □□ □ 

rrpl = MPFROMP (PCONFIGDATA) ; / * Pointer to the CONFIGDATA structure */ 

rrp2 = 0 / * Not used */ 

IM. CREATE. WPS. OBJECT □□□□□□□□□□ 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (PINSTOBJECTDATA) ; / * Pointer to the 

INSTOBJECTDATA structure */ 

IM- DESTROY- WPS- OBJECT □□□□□□□□□□□□ 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (HOBJECT) ; / * This must be the exact OBJECTID 

with which the object was created */ 

IM. EA. JOIN □ EAD □□□□□□□□□(□□□□□□□□□)□ 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (PINSTEAJOIN) ; / * Pointer to the INSTEAJOIN 

structure */ 

IM. EA. LONG. NAME. JOIN □□□□□□□□ (longname)D EADD ,□□□□□□ 

□ □□□□□□□□ 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (PINSTEALONGNAMEJOIN) ; / * A pointer to the structure 

that contains the long name 
as an ASCII string, the file or 
directory name to which the long 
name is t 〇 be applied, and the 
new EA name */ 













IM LOG. ERROR □□□□□ MINSTALL. LOG □□□□□□□□□□□ 

□ □□□□□□□□□□□□□ 

rrpl = MPFROMP ( (PSZ) pszStatement) ; / * The text of the message to insert 

at the end of the MINSTALL iOG 
file */ 

rrp2 = 0 ; / * Not used */ 

IM. MCI. EXTENDEN. SYSINFO mciSendCommand MCI. SYSINFO □□口 口 

rrpl = MPFROML ( LONG) ; / * The MCI _ SYSINFO extended function desired */ 

rrp2 = MPFROMP ( * MCI - SYSINFO- PARMS) ; / * the SYSINFO 

structure * / 



IM- MCI- SEND- COMMAND 

rrpl = 0; 

rrp2 = MPFROMP (PINSTMCISENDCOMMAND) ; 



□ □ MCI □ □ □ 




Not used */ 




Pointer t 〇 the IlNIiSTMCISENDGOMMAND 



structure */ 



IM. MIDIMAP. INSTALL □ □ MIDI □ □ □ 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (PMIDIMAPINiSTALLDAIAh / * Pointer to the 

MIDIMAPINSTALLDATA structure */ 



IM. MM 10. INSTALL □ □ IOProc 口 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (PINSTIOPROC) ; / * Pointer to the INSTIOPROC structure */ 

IM. QUERYPATH □□□□□□□□□□□□□ 

rrpl = PMFROMP (PSZ) ; / * The name of the file needed */ 

rrp2 = PMFROMP (PSZ) ; / * The full path to the file */ 

IM. SPI. INSTALL □□□□□□□□ 

rrpl = 0; / * Not used */ 

rrp2 = MPFROMP (PSZ) ; / * The fully qualified path of a SPI resource DLL */ 



□ 5-6 □□□□□ \ TOOLKIT \ H □□□□□ MINSTALL. !!□□□□□□□ 

□ □□□ DLL □ □□□□□□□□□: 

□ □□□□□□□□□□□□□□□ !□□，□□□□□□□ SPTR- WAITQ 
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■ □ ini □ □ □ config. sys □□□□□, p 〇 dddddd,ddddd mm 

DISPA TCHVARS □ MM - DISPATCHMESSAGS ( ) □ □□□□□□□□□□□ 
(□□□□□□□ MINSTALL. H[] □□□□□)□□□□□□□□□，□□ DLL 
□ □ □ MINSTALL □□□□□□□□□□ 

5.5 □□□□□□□□□□ 

□ □□ (mcd)Q 

1. □□□□□□ MCD □□□□□ INI □□□□□□□□□□ MMPM2. INI □ □ 

□ □□□□□□□□□□□□□□□□□□ MCD, □□□□□□□□ MCD □ □ □ □ □ 

□ □ 09 5-14 □□□□，□□□□□ INI □□□□□□□□□□□ 

□ □□□□□ SoundBlaster Waveform Audio Driver] □□□□□□□□□□ 

My NewMCD” □□□□□□□□□□□□□□□ INI □□□□□□□□□□□□□□， 

□ □ □ □ □ 5 5 .3 □ MMPM2. INI □ □ □ □ □ □〃口 



McilnstallDrv = 

( 

DrvInstallName = "MyWaveSBO 1 〃 

DrvDeviceType = 7 

DrvDeviceFlag = OIL 

DrvVer sionNurribe r = " 1 〃 

Drvproductlnfo = "Sound Blaster Pro M 〇 /’ 
DrvMCD Driver = "MyNe^XICD" 

DrvVSD Driver = "Audioif"’ 

DrvPDDName = " SBAUD 1 

DrvMCD Table = "MEM 

DrvVSD Table = 

DrvSha reType = 3 

DrvRes ourceName = " Soundblas terWO 1" 

DrvRes ourceUnit s =1 
DrvClassArray [ 1 ] = 

( 

( DrvClass Number = 1) 



MciInstallParm = 

( 

PamlnstallName = "MyWaveSBO 1" 

ParmString = ’’FORMAT = 1, SAMPRATE = 22050, BPS = 8, CHANNELS = 2, 

DIRECTION = PIA/ 
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McilnstallConn = 



ConnlnstallName = 〃 MyWaveSB 〇 l 〃 

ConnArray[l] = 

( 

( 

ConnType = 3 / * Wavestream connector */ 

Connlnstal ITo = " MyAmpMixSBO 1 / * Connect to anpmixer */ 
ConnlndexTo = 1 / * First connector in 

anpmixer */ 



McilnstallAlias = 

( 

A1 ias I nst al IName = " MyWave SB 0 1" 
AliasString = ’’Wave Audio” 

) 

McilnstallExt = 

( 

ExtlnstallName = ’’MyWaveSBO 1" 
ExtArray[l] = 

( 

(ExtString = " WAV ’ ） 



□ 5-14 □□□□□□□□□□□□ 

2. □□□□□□□□□□□□□□□□□□□□ 5. 8 □"□□□□□□□，，□ 

3- □□□□□□□ SSINICH □□□□□□□□□□□ INI □□□□□□□□□□ 
CONTROL .SCR □□□□□〃□□，□□□□□□□□□□□□: 

I SSINICH = "MYMCD SCR 〃 | 

□ □ □ □ □ \ TOOLKIT \ SAMPLES \ MM \ 0?□□□□□□□□□□□□□□ 

□ □□□□□□ mcd □□,□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □，□□□□□□ MMPM2. INID □ ,□ MCDDRIVER = AUDIOMCD □ □ □ □ MCD- 
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DRIVE= AUDIOMCT[] □□,□□□□□□□□□□ MCD □□□□□□□□,□□□ 

□ □□□□□□ CONFIG. SYS □ □ □ LIBPATH \ MMOS2 \ DLL ) 口 

□ □□□□□□□□□□□□□, 〇 s / mcd □ □ □ □ 

□ □ □ □ MCDQ 

□ □：□□□□□ MCD □□□，□□□ MMPM2. INI 

□ □□□□□ MCD □□□□□□□□□□□□□□□ 

5.6 □□□□□□ 

□ MINSTALL □□□□□□□□□，□□□□□□□： 

1- □□□□□□□□□□ SpiGetHandler Q Q Q 

2- □□□□□□□□□□,□□/□□□□□□□ SPI.INIQ □ □ □ SPCB( stream 
protocol control blocks) □□□□ □ 

3- □□□□□□□□□ DLL, SSM □ □ □ □ □ DOSLoadModule □□□□□□□ 

□ ;□□□□□□□□□□□□□□□, SSM □□□□ DOSLoadModule, □□□□□□ □ 

□ , CONFIG. SYS □□□□□□□□□□□□□□ 

□ SSM □ □ □ □ □ SPCB □ □ , SPCB □ □ □ □ □ SPI. INI □ □ □ □ SPI. INI □ □ 

□□□□□□□□ 

561 □□□□□ 

□ □ □ SPCB □ □ □ □ □ SPI. INI 

□ □□□□□□□□ SPI.INIQ □□□□□□□□□□□□□□ 5-15 □ □ □ 



# include < os2 h> 

# include < os2me .h> 

# define SPI. RESOURCEl (SPI. RESOURCE + 1) 

# define SPI. RES0URCE2 (SPI. RESOURCE + 2) 

# define SPCBHAND- RCVSYNC. GENSYNC. GENTIME 

( SPCBHAND - RCVSYNC + SPCBHAND - GENSYNC + SPCBHAND - GENTIME) 

RCDATA SPI . RESOURCE 
BEGIN 

2 / * number of stream handlers resources */ 

END 

RCDATA SPI . RESOURCEl 
BEGIN 
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"TESTSYS \ 0 ”， 


/ 


氺 


Class name 


*/ 


"R3TEST \ (T, 


/ 


氺 


Handler name 


*/ 


SH. DLL. TYPE, 


/ 


氺 


PDD or DLL flag 


*/ 


"R3TEST \ (T, 


/ 


氺 


PDD or DLL name 


*/ 


1, 


/ 


氺 


Number of SPCBs 


*/ 


SPCBSIZE, 


/ 


氺 


Length of SPCB 


*/ 


DATATYPE- GENERIC, 


/ 


氺 


Data type 


*/ 


SVBTYPE. NONE, 


/ 


氺 


Sub type 


*/ 



〇 L, 

〇 L, 

〇 L, 

1L, 

4096L, 

2l, 

4l, 

1L, 

2l, 

SPCBBUF- NONCONTIGUOUS, 
SPCBHAND. RCVSYNC, 

〇 L, 

〇 L, 

〇 L, 

〇 L 



* Internal key 

* Data flag 



*/ 

*/ 

*/ 

*/ 

*/ 



* # of records 

* Block size 

* Buffer size 

* Min # of buffers */ 

* Max # of buffers */ 

* # errpty buffs to start src */ 

* # full buffs to start tgt */ 

* Buffer flag */ 

* Handler flag */ 

* Sync tolerance value */ 

* Save sync pulse generation */ 

* Byte^ unit of time */ 

* MMTIME each unit represents */ 



END 

RCDATA SPI . RES0URCE2 
BEGIN 



’’TESTSYS \ 0 ”， 


/ 


氺 


Class name 


*/ 


〃 R 〇 TEST \ CT , 


/ 


氺 


Handler name 


*/ 


SH- PDD- TYPE, 


/ 


氺 


PDD or DLL flag 


*/ 


〃 R 〇 TEST SYS \ 0 〃， 


/ 


氺 


PDD or DLL name 


*/ 


2, 


/ 


氺 


Number of SPCBs 


*/ 


SPCBSIZE, 


/ 


氺 


Length of SPCB 


*/ 


DATATYPE. ADPCM. AVC, 


/ 


氺 


Data type 


*/ 


〇 L, 


/ 


氺 


Sub type 


*/ 


〇 L, 


/ 


氺 


Internal key 


*/ 


SPCBDAT A. CUETIME, 


/ 


氺 


Data flag 


*/ 


〇 L, 


/ 


氺 


# of records 


*/ 


1L, 


/ 


氺 


Block size 


*/ 


4096L, 


/ 


氺 


Buffer size 


*/ 
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SPCBBUF- NONCONTIGUOUS, 



/ * Min # of buffers */ 

/ * Max # of buffers */ 

/ * # enpty buffs to start src */ 

/ * # full buffs to start tgt */ 

/ * Buffer flag */ 



iSPCBHAND_ RCVSYNC- GEKSYNC- GENTIME, / 氺 Handler flag */ 
〇 L, / * Sync tolerance value */ 



SPCBSIZE, 

DATATYPE. WAVEFORM, 



SPCBDATA. CUETIME, 



8192L, 



SPCBBUF- NONCONTIGUOUS, 



/ * Save sync pulse generation */ 

/ * Byte^ unit of time */ 

/ * MyiTIME each unit represents */ 

/ * Length of SPCB */ 

/ * Data type */ 

/ * Sub type */ 

/ * Internal key */ 

/ * Data flag */ 

/ * # of records */ 

/ * Block size */ 

/ * Buffer size */ 

/ * Min # of buffers */ 

/ * Max # of buffers */ 

/ * # enpty buffs to start src */ 

/ * # full buffs to start tgt */ 

/ * Buffer flag */ 



iSPCBHAND- RCVSYNC_ GEKSYNC- GENTIME, / 氺 Handler flag */ 

〇 L, / * Sync tolerance value */ 

〇 L, / * Save sync pulse generation */ 

〇 L f / * Byteg/ unit of time */ 

〇 L / * MyiTIME each unit represents */ 




□ 5-16 □ □ □ 
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5 J6 2 □□□□□□□□ DLL 



□ □，□□□□□□□□□□□□□ DLLO □ DLL □□□□ SPI. INI □ □ 

□ □□□□□□□□□□□□□□□□ dll ： 

I F MAKERES 



□ 5-17 □ □ □ □ □ □ .MAK □ □ (MAKERS. MAK),Q □□□□□□□□ 
□ □□□□□ TESTRES.CLL 口 



.SUFFIXES^ £：om £ys Bxe obj xnbj .asm .inc .def .lrf .erf .ref \ 
1st •sym map c h lib msg pro txt cod rvk 
RCDLL = testres 



* Corrpiler and Tools location */ 



MSRC = 


• • 




TOOLS = 




. . \ TOOLS 


SHIP - LIB = 




. . \ SHIP - LIB 


SHIP - H 二 


. .\ SHIP- H 


SHIP- INC = 


. .\ SHIP. INC 


COMyDN = 


. . \ COMMON 


INC = 




. . \ SRC \ INC 


H = 




. . \ SRC \ H 


H386 = 




. .\ SRC \ H386 


LIB = 




. . \ SRC \ LIB 


LIB386 = 




. .\ SRC \ LIB386 



/ * Definitions for C Corrpiler */ 

CCCMP386= cl386 

CFLAGS386=/ C/ G3 / AS/ W3 / Od/ DLINT. ARGS 

CINC386 =-I .-I 口 (SHIP.H) -IQ (CayMON) -IQ (H386) -I 〇 (H386) \ SYS-I 〇 (H) -I 〇 (H) 



* Definitions for linker */ 



LINK386 = link386 

LFLAGS386 = Q (LNK- DEBUG) / batch/ map/ nod/ noi/ packcode/ packdata 
LIBS386 = □ (NAMELIB) os2386 libc doscalls 



profile 



□ 5-15 



SYS 
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* Definitions for RESOURCE corrpiler */ 



RCINC =-i □ (H) -i G (SHIP. H) -i D (COMyDN) 






* Object file lists 






RCOBJS 



Q (COMMON) \ rcstub doj 






* Inference Rules 






job j 命 



□ (CCOMP386) □ (CFIAGS386) □ (CINC386) / F 〇 口 ( < R) .ob j □ (C- LST) □ ( < R) *c 






* Target Descriptions 






(H) \ common jnak” 



! include 



a 11 命 






SSMRES DLL Target Descriptions 






rc_ □ (RCDLL) .dll 

□ (RCDLL) dll 命 □ (RCOBJS) 口 (RCDLL) .rc make res mak □ (RCDLL) .lrf 
□ (RCDLL) .def 

□ (LINK386) 〇 (LFLAGS386) @〇 (RCDLL) .lrf 

□ (RC) 〇 (RCINC) 〇 (RCDLL) xc □ (RCDLL) dll 



# Make DEF file 



□ (RCDLL) def 命 makeres jnak 

@ echo Creating file << □ (@B) def 
LIBRARY 口 (RCDLL) 

DESCRIPTION "DLL file containing resources' 

STUB ' 〇 S2 STUB EXEf 
DATA NONE 
< < keep 



# Make link response file 

# 
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□ (RCDLL) lrf 命 makeres jnak 

@ echo Creating file << □ ( @ B) J_rf 

□ (RCOBJS) 

□ (RCDLL) dll 

□ (RCDLL) map 〇 (LFLAGS386) 
os2386 libcdll 

□ (RCDLL) def; 

< < keep 



□ 5-17 □□□□□□ DLL MAK □ □ 

563 □ □ SPI. INI □ □ 

□ ■ MAK □□□□□ DLL Spilnstall □□□□ □ 

SPI.INID □(□□ 5.1 □"□□□□□〃□ 5.2 □ 

SPI. INI □□□□□□□ : 

■ INI □ □ □ □ □ □ 

■ CONTROL SCR □□□ □ 

■ FILELIST. TLK □ □ □ □ 

□ □□□□□□□□□ TESTRES. DLL □□□□□□□□□□ 

□ 5-18 □□□□□□□□□□□□□□□□□ TEST. SCR □ INI □□□□□□ □ 
□ □ DLLD □ (TESTRES. DLL)D 

Spi Inst all = 

( 

SpiDllName = 〃□ (DEST) TESTRES DLL” 



□ 5-18 □ □ □ □ SPI. INI □ INI □ □ □ □ □ □ 

□ 5-19 □□□□□□□□ CONTROL. SCR □□□□□□ □ TEST. SCR □□□ □ 

□ □ □ 

package = "SPI .INI Update" 
codepage =437 
filelist = " TEST jyMl" 
groupcount = 2 
munitcount = 1 

medianame = "SPI .INI Update Disk 1 〃 
s ourcedir =〃 \\〃 =0 

destindir = " \ \ My 〇 S2 \ \ DLL \ \ 〃 =2 
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destindir 


=〃 \ \ MMO 沒 \ \ INSTALL \ \ 〃 


=4 


s sgroup 


=0 




ssname 


- Base 




s s vers ion 


="l J 〇 ff 




sssize 


=10 




s sgroup 


= i 




ssname 


=" SPI .INI Update" 




s s vers ion 


="l J 〇 ff 




sssize 


=10 




s sinich 


=〃 TEST .SCR” 





□ 5-19 □□□□ SPI. INI □ CONTROL. SCR □ □ 

□ 5-20 □□□□□□□□□ FILELIST. TLK □□□□ □ TEST. SCR □ □ INI □ 

□ □□□□□ 



/ * 


Total 


number of entries is 3 


*/ 




3 










/ * 


Disk # 


Group # 


Dest # 


Path 


FileName */ 




0 


i 


2 


0 


’’TESTRES DLL” 




0 


i 


4 


0 


"TEST .SCR” 




0 


0 


4 


0 


"TEST .SCR” 



□ 5-20 □□□□ SPI. INI □ FILELIST. TLK □ □ 



5 6 4 □ □ □ □ □ 

□ □□□□□□□□□□ SPCB □□□ SplinstallProtocolO □□，□□□□□□□□ 

□ □□□□□□□□□□□ SPCB, □□ SPCB □□□□□□□ SPCB □□□□□□□ ， 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□ 

□ □ □ □ □ SPCBD □ □ □ □ □ SPCB □□□□□ 〇 ,□□□□□□□□□□□□□□□ 
SPCB 

□ □ □ 

□ 5-21 □□□□□□□□□□□□□□□□ 

RC ShclnstallProtocol (pipparm) 

PPARM- INSTPROT pipparm; 

{ / * Start of ShclnstallProtocol */ 

RC rc = NO . ERROR; / * local return code */ 
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int not found = TRUE; 

PESPCB pTerrpEspcb; 

PESPCB pPrevEspcb; 

/ * the ESPCB list is under semaphore control */ 

if ( ! (rc=D 〇 sRequestMutexSem(hmtxGl 〇 balData, SEM- INDEF 皿 TE_ WAIT))) 

{ / * obtained semaphore */ 
if (pipparm- > ulFlag & SPI. DEINSTALL. PROTOCOL) 

{ / * Deinstall */ 

/ * T 〇 Deinstall, Find the spcb, */ 

/ * Take it of f the espcb chain, */ 

/ * Free the espcb memory allocated */ 

rc = ERROR- INVALID- SPCBKEY; 
pPrevEspcb = NULL; 
pTerrpEspcb = pESPCB. List Head; 
while (pterrpEspcb & & notfound) 

{ / * Loop thru espcbs */ 
if ( (pipparm - > spcbkey .ulDataType= = 

pTerrpEspcb - 〉 spcb jspcbkey ulDataType) & & 
(pipparm - > spcbkey .ulDataSubType = = 

pTerrpEspcb - > spcb jspcbkey nlDataSubType) & & 
(pipparm - > spcbkey .ulIntKey: = 

pTerrpEspcb 圓 > spcb jspcbkey ulIntKey) ) 

{ / * found match */ 
notfound = FALSE; 
rc = NO- ERROR; 

/ * Take the espcb off the chain */ 

if (pPrevEspcb) 

{ 

pPrevEspcb - > pnxtESPCB = pTempEspcb - > pnxtESPCB; 

} 

else 

{ 

pESPCB. ListHead= pTerrpEspcb - > pnxtESPCB; 

} 

HhpFreeMem(hHeap f pTerrpEspcb) ; 

} / * found match 氺 / 
else 

{ / * try the next espcb in the chain */ 
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pPrevEspcb = pTerrpEspcb; 
pTerrpEspcb = pTerrpEspcb - > pnxtESPCB; 



} / * try the next espcb in the chain */ 

} / * Loop thru espcbs */ 

}/ * Deinstall */ 
else 

{ / * Install */ 

/ * If the SPCB already exists then error */ 

if (ShFindEspcb (pipparm - > spcbkey) ) 

{ 

rc = ERROR- INVALID. SPCBKEY; 

} 

else 

{ / * OK to add spcb * / 

/ * Allocate the espcb and put it on the front of the chain */ 

pTempEspcb: (PESPCB)HhpAll 〇 cMem(hHeap, size 〇 f( ESPCB)); 
if (pTempEspcb) 

{ 

pTerrpEspcb - > spcb = 氺 （pipparm - > pspcb) ; 
pTerrpEspcb- > pnxtESPCB= pESPCB. List Head; 
pESPCB- ListHead: pTerrpEspcb; 

} 

else 

} 

rc= ERROR- ALLOC- RESOURCES; 

} 

} / * OK to add spcb * / 

} / * Install */ 

DosReleas eMutexSem ( hmtxGl obalData) ; 

} / * obtained semaphore */ 
return (rc) ; 

} / * End of ShclnstallProtocol */ 

□ 5-21 □□□□□□ SHIPROT.CD □ 

□ SPCB □□□□□□，□□□□ 3 
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57 □ □ V OQQ 

□ □□□□ !/ 〇 □□,□□□□ ^ODDDDDDD mmpmmmio. ini □ □ □ , □ 

□ □□□□□ INI □□□□□□□□ mmioIniFileHalder □□□□□□□□□ PO []〇 

□ !/ 〇 □□□□□□□□□□□ ^ 〇 DDDDD 

□ 5-22 □ □ □ □ mmiolnstall □□□□□□□ ^ 〇 DDDDDDD MINSTALL Q 

□ □ , MMPMMMIO. INI □ □ □ mmio Install □□□□□□□□□□ 



mmiolnstall = 

( 

mmioFourCC 
rtimioDllName 
rnmioDllEntryPoint 
mmioFlags 
mmioExt en dLen 
mmioMedia Type 
mmi 〇 I 〇 Pr 〇 cType 
mmioDefExt 



= fourcc 
= " full patlf 
= "entry name” 
flags" 

=" extend length" 

= "media type" 

=" file format" 

=" default extension 



□ 5-22 mmiolnstall □ 



fourcc 
full path 

entry name 
flags 

extend length 
media type 
file format 
default extension 



□ O □□□ FOURCC 口 

□ □ IOProc DLL 5.4 

□ □□□□□□ 

□ □ IOProc DLL □□□ □ 

□ □□□□□□ MMIO □□□□□□ MMIO □□□，□□ 〇 □ 

□ □□□□□□ 

□ □□□□□□□□ 

□ □ IOProc □□，□□□□□□□□□□□ IOProcD 

□ □□□□□□□□□ 



□ □，□□□ AVC □□]/0□□，□□□□□ INI □□□□□□□□□ mmiolnstall 

□ □ 



mmiolnstal 1 = 

( 

mmioFourCC = " AVCA" 

rtimioDllName ="□ (DEST) AVCAPROC 

mmioDl lEnt ryPoi nt = " AVCAI 〇 Pr 〇 c 〃 
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mmioFlags = 〇 L 

mmioExtendLen = 1 6L 

mmioMediaType = 2L 

mmi 〇 I 〇 Pr 〇 cType = 2L 

mmioDefExt =" 



□ □□□□□□□□□□□□ SSINICH □□□□□□□□□□ INI □□□□□□ 
□ CONTROL. SCR □□□□□〃□□□□□□□□□: 



SSINICH = "BASEl .SC^ 



□ □ \ MMOS2 \ INSTALL □□□□□ BASE1. SCR □□□□□□ mmio Install □ 

□ □□□□□□□□□□□□□ (MMPMMMIO. INI) □□ mmioIniFileHandler □□□ □ 

□ □□□□ !/〇□□□ 

□ 5-23 □□□□□□□□□□□□ mmioIniFileHandler □□□□□ 09 21.3 PM 

□ □□□ !/〇□□□ 

# define FOURCC . OSl 3 mmioFOURCC ( 0\ ' ^ ' Y , ' ?! ) 

# pragma linkage (mmioIniFileHandler, system) 

void main () 

{ 

ULONG rc; 

MMIIS [IFILEINFOmminifileinfo; 

rriminif ileinfo .fccIOProc = FOURCC. OSl 3; 

strcpy (mminifileinfo •szDLLName, " 〇 Sl3PR0CT ) ; 

strcpy (mminifileinfo •szProcName, " 〇 Sl3BITMAPI 〇 PR0Cf ) ; 

rriminif ileinfo .ulExtendLen = 16L; 

rriminif ileinfo .ulFlags = 〇 L; 

rrminifileinfo .ulMediaType: MV [ 工 〇 _ MEDIA. IMAGE; 
mrdnif ileinfo .ulI 〇 Pr 〇 cTYpe = ]yiy[I 〇 _ I 〇 PROC_ FILEFORMAT; 
strcpy (mminifileinfo •szDefExt, 〃 〃） ； 

print f ("Installing 〇 S/ 2 PM Bitmap (Vl 3) IOProc \ n ) ; 

rc = mmioIniFileHandler (&rrminif ileinfo, MV [ 工 〇 _ INSTALLPROC); 
switch (rc) 

{ 

case MMIO. SUCCESS+ 
print f ( 〃工 nstal ling Complete \ n 〃） ； 
break; 

case MMIOERR. INVALID. PARAMETER 令 
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printf ("Error in this install program \ n") ; 
break; 

Case MMIOERR. INTERNAL. SYSTEM^ 
printf 2 MPM System Error \ n") ; 
break; 

case MMIOERR. NO. CORE 命 

printf (’’Memory unavailable for this IOProc \ n") ; 
break; 

case MMIOERR. INI- OPEN 命 

printf ("Unable t 〇 access the 2 MMPMyiMIO JNI file \ n 〃） ； 
break; 

case MMIOERR- INVALID - FILENAME 命 
printf ("Cannot find the file^ OS13PROC DLL \ n ) ; 
break; 
default 命 

printf ("Unknown error attenpting to install 0 $ 2 Bitmap V(1 3) \ n ) ; 
break; 



□ 5-23 □ □ V 〇 UU 

□ MMPMMMIO. INIDDDDD PODDDDDDDDDDDDDD^DDDD 

□ □ os^2DDDDD,p 〇 DDDDDDDDD ： i 〇 Pr 〇 c □ □ □ □ dll □ □ □ , □ □ □ 

□ □ DLL □□□□□□□□□ IOProcQ 



5.8 □□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□,□□ 

□ □ MCD □□□□□□□，□□□□□□□□□□□，□□□□□□□□□□□□□□ 

□ □ □ 

□ □:□□□□□□□□□□ MCD 2[] 2. 10 □" □□□□□ 

□ □□□□□□『□ 

MDM □ □ MMPM2. INI □□□□□□□□□□□□□□□□□□□□ 
MMPM2. INI □□□ MINSTALL[] □□□□□ MMPM2. INI □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□，□□□□□□□□□□□□ MDM □ □ □ □ 

□ □□□□□□□□□ ProfileData □□ INI □□□□□□□□□□□□□□,□□ 

□ □ □ □ ： 
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1- □□□□□□□□□□□□□□□ 5-24 □ □ □ 



HWND Ins ertExanplePage( PMCI_ DEVICESETTINGS. PARMS pMCIDevSettings) 



HV\/ND hwndPage; 

CHAR szTabText[CCHMAXPATH] ; 
ULONG ulPageld; 



* Page window handle */ 

* Buffer for tab string */ 

* Page Identifier 



*/ 



* Load a modeless secondary window 



*/ 
氺氺 / 



hwndPage 



= WinLoadSecondaryWindow ( 

pMCIDevSettings - 〉 hwndN 〇 teb 〇〇 k, 
pMCIDevSettings - 〉 hwndN 〇 teb 〇〇 k, 

Exairple PageDlgPr 〇 c , 
vhmodMRI, 

ID- EXAMPLE, 

(PVOID)pMCIDevSettings) ; 
if ( ! hwndPage) return (NULL) ; 

ulPageld: (ULONG) WinSendMsg( pMCIDevSettingsOhwndNotebook^ 

BKM_ INSERTPAGE, 

(ULONG) NULL, 

MPFR0M2 SHORT ( BKA. AUTOPAGES I ZE I 
BKA. MINOR, BKA_ LAST ) ) ; 

* Associate a secondary window with a notebook page • 



*/ 
氺氺 / 



WinSendMsg (pMCIDevSettings - > hwndNotebook, BKM. SETPAGEWI]®OWHIa/ND, 
MPFROMP ( ulPageld ) , MPFRCMLONG( hwndPage ) ) ; 

* Get Tab Text from DLL */ 

WinLoadString(WinQueryAnchorBlock ( HWND. DESKTOP ) f vhmodMRI, 

(USHORT) IDB_ EXAMPLE, CCHMAXPATH, szTabText); 

* Set Tab Text */ 

WinSendMsg( pMCIDevSettings->hwndN 〇 teb 〇〇 k, BKM_ SETTABTEXT, 

MPFROMP ( ulPageld ) , szTabText ) ; 



■ 237 ■ 





return ( hwndPage ) ; 

} 

typedef struct { 

HWND hwndHelpIn stance; 

} MMPAGEINFO; 

typedef MMPAGEINFO * PMMPAGEINFO; 



Modeless secondary window procedure */ 



MRESULT EXPENTRY ExairplePageDlgProc (HWND hwnd, USHORT msg r 

MPARAMrrpl, MPARAM rrp2) 

PMMPAGEINFO pMMPagelnfo = (PMMP AGE INFO) 

WinQueryWindowPtr (hwnd, QWL. USER) ; 



switch (msg) { 

case WM_ INITDLG 命 

/ * Initialize The Page */ 

pMMPagelnfo = (PMMPAGEINFO) malloc (sizeof (MyPAGEINFO) ) ; 
WinSetWindowPt r (hwnd, QWL _ USER, pMMPagelnfo) ; 

/ * Create a Help Instance */ 

pMMPagelnfo - > hwndHelpInstance = WinCreateHelpInstance( . . .) ; 
break; 

case WM_ DESTROY 命 

/ * Clean up page window resources */ 

WinDestroyHelpInstance (pMMPagelnfo- 〉 hwndHelpInstance) ; 

free (pMMPagelnfo) ; 

break; 

case WM_ COMMAND 命 

/ * Process All Commands */ 
return ( (MRESULT) FALSE) ; 
break; 

case MM- TABHELP 命 

/ * Display help for a tab */ 
if (pMMPagelnfo 圓 〉 hwndHelpInstance) { 

WinSendMsg ( 

pMMPagelnfo- > hwndHelpInstance, 

HM. DISPLAY. HELP, 

MPFR 〇 MSH 〇 RT(WinQueryWind 〇 wUSh 〇 rt(hwnd, QWS_ ID) ), 

HM. RESOURCEID ) ; 
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break; 

case 丽 _ CLOSE 命 

return ( (MRESULT) FALSE) ; 
break; 

case V\M- HELB 

if (pMMPagelnfo _ 〉 hwndHelpInstance) { 

WinSendMsg ( 

pMMPagelnfo _ > hwndHelpInstance, 

HM. DISPLAY. HELP, 

(MPARAM) rrpl, 

HM. RESOURCEID ) ; 

} 

return ( (MRESULT) TRUE) ; 
break; 

case Wl. TRANSLATEACCEL^ 

return (WinDefWindowProc (hwnd, msg, mpl , rrp2) ) ; 
break; 

case HM- QUERY- KEYS- HELB 

return ( (MRESULT) IDH-HELPFORKEYS); 
break; 

} 

return (WinDefSec 〇 ndaryWind 〇 wPr 〇 c(hwnd, msg, rrpl, mp2)); 

} 

□ 5-24 □□□□□□□ 

2. Q Q 5-25 □□ ,□□□□□□ ProfileData 〇 □ INIQ □□□□□□ 

Prof ileData = 

( 

ini ="〇 (DIR) 0 \ \ MyPM / * Name of the INI file */ 

appname = "STPM- SettingsPage 命 7" / * External settings pages */ 

keyname = "UniqueName” / * Name of the page */ 

dll =〃RESDLLNAMEr / * Resource DLL name */ 

id= 33L / * Resource ID */ 

) 

□ 5-25 □□ INI □□□□□□□□ ProfileData □ 
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□ □，□□□□□□□□□□ STPM- SettingsPage: #□□□ #□□□ MCI - DE- 
VICETYPE . xxx □□□ #□□ 〇 ,□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□ dll □□□□□□ RCDATA □ □ □ □ DLL 

□ □□，□□ RCDATA □□□ ID[] RCDATA □ □ □ □ ID 

□ ， □□□□□□□□□ ， □□ ， 33L 〇 

□ □ INI □□□□□□, □□□□□□□□□□□□ DLLD □□□□□□□ DLLQ 

□ □□□□□□□□□□(□ DLL □□□□□□□□)□□□ 5-26 □□□□□□，□□ 
□" Make Page, InsertExamplePage" □ 

RCDATA 33 
BEDIN 

〃 Ma kePage , Insert ExairplePa ge" 

END 



□ 5-26 □ MM □□□□□□□□□□□ RCDD 

□ □□□□□□□□□ DLL □□ RCDATA □□□□□□□□□□,□□ OS/ 2 □ 
□ PrfWriteProfileData □□□□□□□□□□□ OS/2 INI □□□□ ProfileData □□□ □ 

□ □□□ INI □□□□□□"□ □□□□□□□□□ 

3. □ CONTROL. SCR □□□□□□□□□□□□ ■□□□□□□□ 

4- □□□□□□□□□ DLL, □□□□□□□□□□□□ 〇 S^ 2 Q PrfWritePro- 
fileData □□□□□□□□ 5-27 □□□ 



hini = PrfCpenProfile TCv \ mmos2 \ mrrpm dni" ) ; 
PrfWriteProfileData (hini. 








"STPM_ SettingsPage+, 


/ 


氺 冲 pname 


*/ 


"UniqueName ” ， 


/ 


氺 Keyname 


*/ 


’’MakePage, InsertExairplePage" , 


/ 


* Value 


*/ 


"strlen ("MakePage, InsertExairplePage") + 1 ) ; 




PrfCloseProfile (hini) ; 


/ 


* Value length 


*/ 



□ 5-27 PrfWriteProfile 〇 Q 
□ □ □ □ PrfWriteProfile □□□□□□□, 

□ □ 



5.9 □ □ LOGO □ 

□ □□ MINSTALLl] □□□□□□ MINSTALL. LOG □□□ LOG □□□□□ □ 
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□ □□□□□□□□□□□□□□□□□□□□□ ,logd □□□□□□□□□□□□ 

□ □，□□□□□□□□□□□□ INSTALL □ □，□□□□□□□□□□□□□□□□ 

□ □□□ PRINT □□□□□□ TYPE □□□□□□□□□□□□□□□□□□,□□ 

□ □□□□： 

TYPE \ MM0S2 \ INSTALL \ MINSTALL .LOG 

□ □ □□□□□□□□□□□ 

□ □□□□□□□□, MINSTALL □□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□，□□□□□□□ LOG □□□□□□□□□□□ 

□ □□□□□□□□ IBM □□，□□□□□□□□ LOG □□□IBM □□□□□□ 

□ LOG □□□□□□□□□□□□□□ 

□ □：□□□□□□□□□□□□□□□□□,□□□□□□ log 

□ □□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□□ 
□ □ □ 

□ 5-28 □□□□□□□□ MINSTALL. LOG □□ □ 

Begin parsing master file-Z^ \ RT \ CONTROL SCR . 

\ RT \ CONTROL .SCR parsed successfully . 

Begin parsing file list-Z^ \ RT \ MASTERH3 J^T 
\ RT \ MASTERH3 RT parsed successfully . 

The following file was copied successfully^ \ MMOS2 \ README 

The following file was copied successfully^ \ My[ 〇 S2 \ MINSTALL EXE 



The following file was copied successfully^ \ MA0S2 \ INSTALL \ WAVEFILE EAS 
Loaded DLL \ MyDS2 \ DLL \ MMSND DLL and calling entry point InstallMyiSound . 
Returned from DLL \ MyDS2 \ DLL \ MMSND DLL . 

Loaded DLL \ MyDS2 \ DLL \ QRYUM DLL and calling entry point LocateUM . 

An extended Sysinfo failed call with dwltem= 1024 . 

An extended Sysinfo failed call with dwltem= 4096 . 

Corrpleted updating MMPM2 JNI with Digital Video Player devices . 

Returned from DLL \ MyDS2 \ DLL \ QRYUM DLL . 

Loaded DLL \ MyDS2 \ DLL \ QRYCD DLL and calling entry point LocateCD . 

An extended Sysinfo failed call with dwltem= 4 . 
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An extended Sysinfo failed call with dwltem= 4 . 

Returned from DLL \ MM0S2 \ DLL \ QRYCD I：LL . 

Loaded DLL \ MM0S2 \ DLL \ QRYAD DLL and calling entry point LocateMAUDIO . 
Corrpleted updating CONFIG SYS with M- Audio devices 
An extended Sysinfo failed call with dwltem= 1024 . 

An extended Sysinfo failed call with dwltem= 1024 . 

Corrpleted updating MMPM2 JNI with M - Audio devices . 

Returned from DLL \ MM0S2 \ DLL \ QRYAD I：LL . 

Starting to parse the file ' \ MM0S2 \ INSTALL \ BASE SCR’ . 

Successfully parsed the file ' \ MM0S2 \ INSTALL \ BASE SCR’ . 

Starting to parse the file ' \ MM0S2 \ INSTALL \ SMVINI SCR’ . 

Successfully parsed the file ' \ MM0S2 \ INSTALL \ SMVINI SCR’ . 

Starting to parse the file ' \ MM0S2 \ INSTALL \ BASECONF Cri . 

Successfully parsed the file ' \ MM0S2 \ INSTALL \ BASECONF Crf . 

Starting to parse the file ' \ MM0S2 \ INSTALL \ SMVCONF Ctf . 

Successfully parsed the file ' \ MM0S2 \ INSTALL \ SMVCONF . 

Loaded DLL \ MM0S2 \ DLL \ ITERM DLL and calling entry point ITermEntry . 
Returned from DLL \ MM0S2 \ DLL \ ITERM JDLL . 

Loaded DLL \ MM0S2 \ DLL \ WEPMPINT DLL and calling entry point WepmPlusAdd . 
Returned from DLL \ MM0S2 \ DLL \ WEPMPINT DLL . 



□ 5-28 MINST ALL .LOG □ □ □ □ 
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□ □A □□□□□□□□ 

□ □□□□□□□ 〇 ^2DDDDDDDDDDDDDDDDDDD[ 
□ □□□□: 

■ □□□□□□ DLL □□□□□□□ 

■ MIDID □ □ □ □ □ DLL 

■ □□□□□□□□DLL 

■ □□□□□□ DLL 

■ CI>DA □ □ □ □ DLL 

■ CD-ROM XA 〇 □ □ □ DLL 

A1 □□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□,[ 

□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□[ 

□□□□□□□□□□□□□□□□□□□□□□□□□□,□□□□□[ 

□/□□□□□□□□□□□□□□□ 

□ □□□□□□□□□DO 3DDDDDDDDDD, □□□□□□ o 

□ □□)□□□□□□□□□ (PDD)Q □ □ 

□ □□□ 3DDDDDDDDDDDDD 3 〇 D dll □ □ codec □ [ 

□ □□□□□□□□ 3DDDDDDDDDD vsd □ □ ddcmd □ □ □ [ 

□ □□□□□□(□□ VSDDDCMD：! □□□□□ □□□09 2[] □□□□ [ 

□ □□□□□□□□□□□□□□□□□□□□□□□ (DDCMD)D [ 

□ □□□□□□□□□□□ 

A .11 □□□□□□ 

□ 3DDDDDDDDDDDDDDDDD ： 

■ □ □ □ AUDIOSH .DLL 

■ □ □ □ □ AUDIOSHD 

■ □ □ □ □ AUDIOSH 

■ DD^ DLL DLL 

■ □ □□□□□□□□□□□□□□□□□□□□□□□□□□[ 
□ □□□□□□,□□□□□□□□□□□□□□□□□□□□□[ 



□ □ □ □ □ 



□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 

□ (□□□□ 

]□□□□□ 
□ □ □ □ □ 
□ □□□□) 
〇□ □ □ □ 



□ □ □ □ □ 
□ □ □ □ □ 
□ □ □ □ □ 
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□ □□□□□□□□□□□□□□□□□□□□□□,□□□□□□ 16 □ PCM 

□ □□□□□ ADPCM □ □ □ 

□ □ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□/□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ (Stream Protocol 
Control Block, □□ SPCB) □ □ 

□ □□□□□□□□□□□□(□□□)□□□□□,□□ 16 □ PCM,AVCD 8 

□ ADPCM, CD-ROM XA □ 8Q ADPCM 〇 □ □ 

□ □□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□ 

□ □□□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□，□□□□□□□□□□□ 

□ □□□□□□□□□□□□□，□□□□□□□□□□□□ SPCB □□□□ □ 

□ □ □ □ □ 



A .12 □□□□□ 



□ 3DDDDDDDDDDDDDDDDD (Device Control Blocks, □ □ DCB)Q 
DCB □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ DCBQD 

□ □ SpiCreateStream □□□□□□□□□□□□□ 

□ 3DDDDDDDDDDD vsd □ □ □ □ □ (vsd-dcb)D vsi>dcb □ □ □ □ 

VSD SpiCreateStream □□ □ 

□ □□□□□□□□□ 




DCB. AUDIOSH - Device Control Block for the 
Audio Stream Handler . 



PACKED STRUCTURE 







typedef struct . deb. audiosh{/ * deb. audiosh- Device Control Block */ 

ULONG ulDCBLen; / * Length of structure 

SZ szDevName[MAX. SPI. NAME] ; / * Device driver name 

ULONG ulSysFil eNum; / * File handle number - From an 



audio, init call 



} DCB. AUDIOSH; 

typedef struct . deb. audiosh FAR * PDCB. AUDIOSH; 



*/ 

*/ 

*/ 

*/ 
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□ A-l □ □ □ □ □ 






氺 






VSD. DCB - VSD Device Control Block 



This structure will allow stream handlers to use the VSD DLL 
by using by the additional fields in the structure . 



氺 


( * * * PACKED STRUCTURE 


氺 


氺 


* ) 




* * * * * 


************** 


氺 


氺 


************* 


氺 氺氺氺 


typedef struct . VSD. DCB {/ * vsd. deb - VSD Device Control Block 


*/ 


ULONG 


ulDCBLen ; 


/ 


氺 


Length of structure 


*/ 


SZ 


szDevName[MAX_ SPI_ 腿 ME] ; 


/ 


氺 


Device driver name 


*/ 


ULONG 


ulSysFileNum; 


/ 


氺 


File handle number 


*/ 


ULONG 


hvsd; 


/ 


氺 


Handle to VSD instance 


*/ 


PFN 


pf nvsdEntryPoint ; 


/ 


氺 


Address of VSD entry point 


*/ 


ULONG 


ulReservedl ; 


/ 


氺 


Reserved for system 


*/ 


ULONG 


ulReserved2; 


/ 


氺 


Reserved for system 


*/ 


} VSD. 


DCB; 











typedef VSD - DCB FAR * PVSD- DCB; 

□ A-2 VSD □ □ □ □ □ 



A .13 □□□□□ 

□□□□□□□□□□□□□□□□□ 

A .14 □□□□□□□□ (EVENT- IMPLICIT. TYPE) 

□ □□□□□□□□□□□□ (EVENT — IMPLICIT — TYPE)!] □□□□□□ : 

1 . EVENT . ERROR 

□ □□□□□□□ ulStatus □□□□□□□□□□□□□□□□□□□□□□□□ 

□ ： 

■ ERROR INVALID BUFFER RETURNED 

■ ERROR DEVICE. OVERRUN 

■ ERROR STREAM, STOP PENDING 
2 . EVENT PLAYLISTCUEPOINT 

□ □□□□□□□□□□□□□□□□□□□□□/□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□ MMIO □□□□□□□□□□□ 
PLAYL. EVCB □ ulMessageParm □□□□□□□□□□□□□□□□□□,□ mm- 

timeStreamQ □□□□□□ 
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A .15 □□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□： 

1 . EVENT . CUE. TIME 

2 . EVENT - CUE - TIME - PAUSE 
3 . EVENT DATAUNDERRUN 

A .16 □□□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□： 

1 . EVENT . CUE- DATA 
2 .EVENT DA TAOVERRUN(D 〇 □ ) 

A .17 □□□□□□□□□□ 

□ □□□□□□□□ (SHC)D □□□□□□□□□ SHC □□□□□□□□□□□ 

□ 2 [] □□□□□□□□□ □ 

1 . SHC- ASSOCIATE 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID REQUEST 

2 . SHC. CLOSE 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 
3 . SHC- CREATE 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR STREAM. CREATION 

■ ERROR INVALID STREAM 

■ ERROR DEVICE. NOT FOUND 

■ ERROR INVALID BLOCK 

■ ERROR INVALID SPCBKEY 
4 . SHC- DESTROY 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID STREAM 
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5 . SHC. DISABLE. EVENT 

□ □□□□□□□： 

■ NO- ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID - EVENT 

6 . SHC. DISABLE. SYNC 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

7 . SHC. ENABLE. EVENT 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR TOO MANY- EVENTS 

■ ERROR INVALID. EVENT 

8 . SHC- ENABLE - SYNC 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID FLAG 

■ ERROR INVALID - STREAM 

■ ERROR STREAM NOTMASTER 

■ ERROR INVALID NUMSLAVES 

9 . SHC. ENUMERATE. PROTOCOLS 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INSUFF BUFFER 

10 .SHC. GET PROTOCOL 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID. SPCBKEY 

11 . SHC - GET TIME 

□ □□□□□□□： 

■ NO- ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID - STREAM 
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12 .SHC. INSTALL PROTOCOL 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID SPCBKEY 

■ ERROR INVALID RESOURCES 

13 . SHC. NEGOTIATE. RESULT 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

14 . SHC. SEEK 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR STREAM NOT SEEKABLE 

■ ERROR DATA - ITEM NOT SEEKABLE 

15 .SHC. START 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID STREAM 

16 .SHC— STOP 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID STREAM 

A .18 □□□□□□□□□□□□ (SPCB) 

□ □□□□□□□□□□ SPCB: 

1 . DATATYPE. WAVEFORM 

□ □ ： 

■ WAVE. FORMAT 1M08 

■ WAVE. FORMAT 1S08 

■ WAVE- FORMAT 1M16 

■ WAVE. FORMAT 1S16 

■ WAVE. FORMAT 2M08 

■ WAVE. FORMAT 2S08 

■ WAVE. FORMAT 2M16 
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■ WAVE- FORMAT 2S16 

■ WAVE- FORMAT 4M08 

■ WAVE FORMAT 4S08 

■ WAVE. FORMAT 4M16 

■ WAVE- FORMAT - 4S16 

■ WAVE— FORMAT 8M08 

■ WAVE- FORMAT - 8S08 

■ WAVE- FORMAT 8M16 

■ WAVE- FORMAT - 8S16 
2 . DATATYPE. ALAW 

□ □ ： 

■ ALAW-8B8KM 

■ ALAW. 8B11KM 

■ ALAW - 8B22KM 

■ ALAW - 8B44KM 

■ ALAW - 8B8KS 

■ ALAW. 8B11KS 

■ ALAW. 8B22KS 

■ ALAW. 8B44KS 

3 . DATATYPE. MULAW 

□ □ ： 

■ MULAW. 8B8KM 

■ MULAW- 8B11KM 

■ MULAW. 8B22KM 

■ MULAW, 8B44KM 

■ MULAW. 8B8KS 

■ MULAW. 8B11KS 

■ MULAW. 8B22KS 

■ MULAW. 8B44KS 

4 . DATATYPE _ ADPCM AVC 

□ □ ： 

■ ADPCM AVC. VOICE 

■ ADPCM. AVC. MUSIC 

■ ADPCM- AVC - STEREO 

■ ADPCM. AVC. HQ 

5 . DATATYPE. MIDI 

□ □ ： 

■ SUBTYPE NONE 




6 . DATATYPE. SPV2 
□ □ ： 

■ SPV2.BPCM 

■ SPV2-PCM 

■ SPV2. NONE 

A .19 □□□□□□ 

□□□□□□□□□□□□□□□ 

A 2 MIDI □□□□□□ 

MIDI □□□□□□□□□□□ MIDI □□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□ MIDI 

□ □□□□□□□□□ 3DDDDD 

A21 □□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ ,□□□□□□□□□□□□□□□□□□□□□□ shc. stop □□□□□□□ 

_ 2 [] □□□□□□□□□ □ 

A22 □□□□□□□□□□□□□ 

□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□: 

■ SEEK 

□ □□□□) 

■ STOP DISCARD □□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□ EOS □,□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□ 

■ STOP FLUSH □□□□□□□□□□□□□□□，□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□ 

■ STOP PAUSE □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□ 

■ START □□□□□□□□□□□□，□□ MIDI □□□□□□□□□□□□□ 
E 〇 SD □□□□□□□□□□□□□□□□□ START □ START PREROLL □ 
□ □□□□□□□□□□□□□□□□ 

■ START PREROLL □□(□□□□)□□□□□□ START PREROLL([] □□ □ 
□ )□□□□□□□□□ START PREROLL 
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■ DESTROY □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ 

■ CREATE □ ASSOCIATE □□□□□□□□□□□□□□□□□□□□□□ 口 

□ □□□□□□□□□□□□□□□□ 

A23 □□□□□□ 

□ MIDI □□□□□□□□□□□□□□□： 

■ □ □ □ MISH DLL 

■ □ □ □ □ MISH 

■ □ □ □ □ MIDISYS 

■ PDI> DLL DLL 



A2 5 □□□□□ 

MIDI □□□□□□□□□□□□□□ A-3 □□□□□□□□ 




* MISH - MIDI stream handler port- stream table ACB 



# define ACBTYPE. MISH 0x0005 L / * MID I port- stream table */ 

typedef struct - acb. MISH / * acbmish - MIDI Assoc . Control Block */ 



ULONG 


ulACBLen ; 


/ 


氺 


Length of structure 


*/ 


ULONG 


ulObjType; 


/ 


氺 


ACB. MISH 


*/ 


HSTREAM 


hstreaunDef ault ; 


/ 


氺 


Default hstream to use when 


*/ 






/ 


氺 


mapper is turned off . 


*/ 


ULONG 


ulReservedl; 










ULONG 


ulReserved2; 










ULONG 


ulNumlnS treams ; 











□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ [DI 
□ [ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



M 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

)□ □ 

□ □ 

□ □ 

/l\ 

□ □ 

□ □ 

□ □ 



□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 



_ — - D s 

_ — - c 



□ 

□ 

□ 



□ 

□ 

□ 

□ 



□ □ 
□ □ 
□ 



□ 

□ 

□ 

□ 



□ 



D □ 



M 



□ 

□ □ 
□ □ 
□ 
□ 

□ □ 
□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

D □ 

M □ 
□ □ 
□ 



□ 

□ 

□ 

□ 

□ 



□ SI 
I 

ro ™u 

M □ 
□ □ 
) D D 

□ □口 

□ □ □ 

/IV 

□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 

□ ^ □ 
□ ]□ □ 
□ ]□ □ 
□ ]□ □ 
□ ]□ □ 

□ m 

□ □ 



D 

I 

M 



□ 

□ 

□ 

□ 

□ 

4 

2 

A 



n 

n 

n 

n 

n 

n 

n 

n 
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HSTREAM 


hstreamInMAX[ - PORTS] ; / 


氺 


Array 〇 f Input streams 


*/ 


ULONG 


ulNumOut St reams ; 








HSTREAM 


hstreamDut [MAX. PORTS] / 


氺 


Array of Output streams 


*/ 




/ 


氺 


The index into the array is 


*/ 




/ 


氺 


the source channel for that 


*/ 




/ 


氺 


stream • 


*/ 



} ACB. MISH; 



* MISH - MIDI stream handler SET ACB 

# define ACBTYPE. SET 0x000 6L / * MIDI set function */ 

typedef struct . acb. set / * acbset - Set Assoc .Control Block */ 



ULONG 


ulACBLen ; 


/ 


氺 


Length of structure 


*/ 


ULONG 


ulObjType; 


/ 


氺 


ACB. SET 


*/ 


ULONG 


ulFlag; 


/ 


氺 


Set flag 


*/ 


ULONG 


ulTerrpo; 


/ 


氺 


Not used . 


*/ 



} ACB. SET; 

/ * ulFlag defines^ */ 

# define MIDI - MAP - ON 0x000 〇 L / * turn mapping function on */ 

# define MIDI. MAP. OFF 0x000 1 L / * turn mapping function off */ 

□ A-3 MIDI □□□□□□□□□□□ (ACB) 

A 2 6 □□□□□□□□ (EVEISTT. IMPLICIT. TYPE) 

□ □□□ MIDI □□□□□□□□□□□ (EVENT — IMPLICIT — TYPE)[] □□ □ 

□ ： 

1 . EVENT - ERROR 

ulStatus □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□： 

■ ERROR INVALID BUFFER RETURNED 

■ ERROR DEVICE- OVERRUN 

■ ERROR STREAM, STOP PENDING 

A27 □□□□□□□□ 

□ □□□□□□ MIDI □□□□□□□□□□ 

A2S □□□□□□□□□□ 

□ □□□□□□□ (SHC)D □□□□□□□□□ SHC □□□□□□□□□□□□ 

□ □09 2 [] □□□□□□□□□ □ 
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1 . SHC. ASSOCIATE 

□ □□□□□□□： 

■ NO- ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR — INVALID - STREAM([] □□ hstream □ hid □□□□□□ ) 

■ ERROR INVALID OBJTYPE([] □ ACBTYPE. MMIO □□□□□ ) 

■ ERROR INVALID BUFFER - SIZE(ulAcbLen □□□□ ) 

■ ERROR — STREAM — NOT — STOP([] □□□□□□□□□□) 

2 . SHC. CLOSE 

□ □□□□□□□： 

■ NO- ERROR 

■ ERROR INVALID FUNCTION 
3 . SHC. CREATE 

□ □□□□□□□： 

■ NO- ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR _ STREAM CREATION 

■ ERROR INVALID. STREAM 

■ ERROR DEVICE. NOT FOUND 

■ ERROR INVALID - BLOCK 

■ ERROR INVALID - SPCBKEY 

■ ERROR. ALLOC. RESOURCES 
4 . SHC- DESTROY 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID - STREAM 

5 . SHC. ENUMERATE. PROTOCOLS 

□ □□□□□□□： 

■ NO. ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INSUFF BUFFER 
6 . SHC. GET PROTOCOL 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID - SPCBKEY 
7 . SHC. INSTALL PROTOCOL 
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□□□□□□□□: 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID SPCBKEY 

■ ERROR ALLOC. RESOURCES 

8 . SHC- NEGOTIATE. RESULT 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR — INVALID — STREAM([] □□ hstream □ hid □□□□□□ ) 

9 . SHC. SEEK 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR STREAM NOT SEEKABLE 

■ ERROR DATA. ITEM NOT SEEKABLE 

■ ERROR INVALID STREAM([] □□ hstream □ hstream □ hid □□□□ ) 

■ ERROR NOT - SEEKABLE - BY TIME 

■ ERROR STREAM NOT STOP 

10 . SHC. START 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID — STREAM([] □□ hstream □ hstream □ hid □□□□ ) 

■ ERROR DATA. ITEM NOT SPECIFIED([] □□□□□ ) 

11 .SHC. STOP 

□ □□□□□□□： 

■ NO ERROR 

■ ERROR INVALID FUNCTION 

■ ERROR INVALID STREAM([] □□ hstream □ hstream □ hid □□□□ ) 

■ ERROR STREAM NOT STARTED 

A29 □□□□□□□□□□□□ 

MIDI □□□□□□□□□□□□□□□□□ (SPCB)D 
1 . DATATYPE. MIDI 

A2 10 □□□□□□ 

□□□□□□□□□ 
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A3 □□□□□□□□ 



A31 □□□□□□ 

□□□□□□□□□□□□□□□□□□□： 

■ □ □ □ FSSH DLL 

■ □ □ □ □ FSSH 

■ □ □ □ □ FILESYS 

■ PDI> DLL DLL 

■ □ □□□□□□□□□□□□ 

□□□□□□□□□□□□□ 

A32 □□□□□ 

□ □ 

A33 □□□□□ 

□ □□□□□ ACBTYPE-MMIOO □□□□□□□□ 

* FSSH - File System Stream Handler MMIO Object ACB 

# define ACBTYPE- My[I 〇 0x0001 L / * MMIO object */ 

typedef struct . ado. mmio / * acbmmio - MMIO ACB */ 

{ 

ULONG ulACBLen; / * Length of structure */ 

ULONG ulObjType; / * ACB. MMIO */ 

HMMIO hrtimio; / * Handle of MMIO object 氺 / 

} ACB. MMIO; 



K □ 
M □ 
M □ 



□ □ 
□ □ 
□ □ 



rL □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
D □ 
D □ 
□ □ 
□ □ 

M □ 

R □ 

TO □ 

n\ o 
□ □ 
□ □ 
□ □ 
M □ 

o □ 
R □ 
D- D 

nc ,r 

□ □□ 
□ □ 
□ □ 
□ □ 
□□ □ 



[ □ 
□ □ 
□ □ 
□ □ 
□ □ 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

Fn a 
if d 
0 □ 



□ □ 
□ □ 



□ [ 
□ □ 
□ □ 
□ □ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
,□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 



□ □□□□□□□ 



□ □ 



□ □ n 

□ □ □ 
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A3 A □□□□□□□□ (EVENTT. IMPLICIT . TYPE) 

■ □□□□□□□□□□□□□□□ (EVENT — IMPLICIT — TYPE)[] □□□□ □ 

□ ： 

1 . EVENT - ERROR 

□ □□□□□□□□□□□□□□ ulFlag □□□□□□□□□□□□□□□□： 

(1) □ □ □ □ —— TEMPORARY , ERROR OxOOOOL 

□ □□□□□□□□□□□□□，□□□□□□□ SSM □□□□□□ SSM □□ □ 

□ □□□□□□□□□ 

(2) □ □ □ □ □ —— RECOVERABLE. ERROR OxOOOlL 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

(3) □ □ □ □ □ □ —— NONRECOVERABLE . ERROR 0x0002L 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

SpiDes troy St ream □□□ □ 

□ □□□□□□□ ulStatus □□□□□□□□□□□□□□□□□□□□□□ 

□ API □□□□□□□□□： 

■ DosGetlnfoBlock 

■ SMHEntryPoint SMH NOTIFY 

■ mmioRead( □□□□，□□□□□□□□□□ mmioGetLastError □ ) 

■ mmioWrite( □□□□□，□□□□□□□□□ mmioGetLastError[] ) 

2 . EVENT PLAYLISTCUEPOINT 

□ □□□□□□□□□□□□□□□□□□□□□ MMIO □□□□□□□□□□□□ 
PLAYL- EVCB □ ulMessageParm □□□□□□□□□□□□□□□□□□□□ mm- 
timeStreamD □□□□□□ □ 

A35 □□□□□□□□ 

□□□□□□□□□□□□□□□□□□ 

A36 □□□□□□□□□□ 

□ □□□□□□□ (SHC)D □□□□□□□□□ shc □□□□□□□□□□□□ 

□ □□□_ 2 [] □□□□□□□□□ □ 

1 . SHC- ASSOCIATE 

□ □：□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR — INVALID — STREAM([] □□ hstream □ hid □□□□□□ ) 

■ ERROR INVALID OBJTYPE([] □□ ACBTYPE. MMIO) 
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■ ERROR INVALID BUFFER. SIZE(ulAcbLen □□□□ ) 

■ ERROR — STREAM — NOT — STOP([] □□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

2 . SHC- CREATE 

□ □:□□□□□□ SpcbkeyO 

□ □ DATATYPE. GENERIC Q □□□□□□□ 

□ □□□□□□□： 

■ ERROR INVALID. SPCBKEY 

■ ERROR ALLOC - RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosCreate Thread 

3 . SHC- DESTROY 

□ □□□□□□□： 

■ ERROR- INVALID. STREAM (□ □ □ hstream □ □ □ hstream □ hid □ □ □ □ 

□ ) 

□ □□ API □□□□□□□□□□□： 

■ DosRequestMutexSem 

4 . SHC- START 

□ □□□□□□□： 

■ ERROR INVALID. STREAM (□ □ □ hstream □ □ □ hstream □ hid □ □ □ □ 

□ ) 

■ ERROR — DATA. ITEM — NOT. SPECIFIED([] □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□□： 

■ DosRequestMutexSem 

5 . SHC. STOP 

□ □□□□□□□： 

■ ERROR INVALID. STREAM (□ □ □ hstream □ □ □ hstream □ hid □ □ □ □ 

□ ) 

■ ERROR STREAM NOT STARTED 

□ □□ API □□□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosResumeThread 

■ DosSuspendThread 

6 . SHC. SEEK 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□□□□ 

□ MMIO IOProc □□□ MMIOM- SEEKBYTIME □□□□□□□□□□□□□□□□ 
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□ □□□□□□□□□□□□ ( mm i 〇 SendMessage)[] (□□ SpiSeekStream SPI — SEEK- 
mmtimed □□□□□□□□ 〇 s^2DDDDD □□□□□□)□□□□ ,SPCB □ □ □ 
spcb .ulBytesPerUnit □ 〇 □ spcb .mmtime Per Unit DDDDDDDDDDDDDDDD 

□ □□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR INVALID STREAM([] □□ hstream □□□ hstream □ hid □□□ ) 

■ ERROR NOT . SEEKABLE . BY . TIME 

■ ERROR DATA. ITEM NOT. SEEKABLE 

■ ERROR DATA. ITEM NOT. SPECIFIED 

■ ERROR STREAM NOT STOP 

□ □□ API □□□□□□□□□□□□： 

■ DosRequestMutexSem 

■ mmioSeek([] □ mmioGetLastError[] □□□□□□ ) 

■ mmioSendMessage □ MMIOM . SEEKBYTIME ( □ □ mmioGetLastError □ □ □ □ 

□ □ □ ) 

7 . SHC. GET PROTOCOL 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

□ □□ API □□□□□□□□□□□□： 

■ DosRequestMutexSem 

8 . SHC. INSTALL PROTOCOL 

□ □：□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

■ ERROR ALLOC. RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

9 . SHC. ENUMERATE. PROTOCOLS 

□ □□□□□□□： 

■ ERROR INSUFF BUFFER 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

10 . SHC. NEGOTIATE. RESULT 

□ □□□□□□□： 

■ ERROR INVALID STREAM (□ □ □ hstream □ □ □ hstream □ hid □ □ □ □ 

□ ) 

■ ERROR— INVALID— FUNCTIO_ □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 
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■ DosRequestMutexSem 



A41 □□□□□□ 



A37 □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□ SPCB,D □ □ DATATYPE- GENERICQ □ □ □ □ 

□ □□□□□□□ SPCBKEY □□□，□□□□□□□□□□□□□□ DATATYPE. 
GENERIC □□□ SPCB □□□□□□□□□□□□□□□□□ intkey □□□□□□□□ 

□ □□□□□□□□□□□ SPCB □□ A-l □ □ 



□ A^l □□□□□□□□ SPCB 



SPCBD □ 


DATATYPE . GENERIC □ 


ulBufSize 


16KB 


ulMinBuf 


2 


ulMaxBuf 


5 


ulSrcStart 




ulTgtStart 




ulBufFlag 


SPCBBUF NONCONTIGUOUS 


ulHandFlag 


SPCBHAND NOSYNC7 SPCBHAND_ PHYS- SEEK 



A 3 8 



□ □口 

□ □ □ 

□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 

□ □ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

/IV 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

4 

A 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 



□ 

□ 

□ 

□ 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ □ 

\—/ 

□ 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 



□ 

□ 

□ 



□ 

□ 

□ □ 
□ □ 
□ □ 
□ □ 



□ □ 
□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 



□ 

□ 



□ 



□ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ 

□ 



□ 

□ 

□ 

□ □ 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 



( □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ ), 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ □ □ 
□ □ □ 
□ □ □ 
□ (□ □ 
□ □ □ 
□ □ 

□ □ 



n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 



□□□□□□□□□□□□□□□： 
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□ □ □ MEMSH DLL 

□ □ □ □ MEMSH 

□ □ □ □ MEMSYS 

PDEy DLL DLL 

□ □□□□□□□□□□□□ 

□ □ □□□□□□□□□□□□□ 

A42 □□□□□ 

□ □ 

A A3 □□□□□ 

□ □□□□□□ ACBTYPE- MEM — PLAYL □□□□□□□□□ 

* MEMSH - Memory Stream Handler Playlist Object ACB 

# define ACBTYPE. MEM. PLAYL 0xD003L / * Memory playlist object */ 

typedef struct _ acb_ mem _ play 1 
{ 

ULONG ulACBLen; / * Length of structure */ 

ULONG ulObjType; / * ACBTYPE. MEM. PLAYL */ 

PVOID pMemory Addr ; / * Starting address of playlist */ 

} ACB. MEM. PLAYL; 



AAA □□□□□□ (EVEISTT. IMPLICIT. TYPE )□ □ 

□ □□□□□□□□□□□□ (EVENT — IMPLICIT — TYPE)[] □□□□□□ : 

1 . EVENT . ERROR 

□ □□□□□□□□□□□□□□□ (evcb)Q ulFlagD □□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□ (A 3. 4 □)□ 

ulStatus □□□□□□□□□□□□□□□□□□□□□□□□□□□□□： 

■ ERROR— PLAYLIST— STACK— OVERFLOW([] □□□□ □ CALL □ □ □ □ □ □ 
CALL □ □ □ 20 □ □ □ ) 

■ ERROR PLAYLIST STACK UNDERFLOW (□□□□□ □ RETURN □□ □ 

□ □□□□ CALL □□□□□□□□□□□ RETURN □□ ) 

■ ERROR— INVALID— FUNCTIO_ □□□□□□□□□□□) 

■ ERROR— INVALID— BLOCK([] □□□□□/□□□□□□□□□□□(□□)□ 

□ (□□)□□) 

■ ERROR— END— OF— PLAYLIST([] □□□□□□□□, EXIT □□□□□ □ EOS 
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■ DosGetlnfoBlock 

■ DosQueryMem 

■ SMHEntryPoint SMH NOTIFY([] □ □ □ □ Give Buf □ □ ) 

■ SMHEntryPoint SMH NOTIFY(D □ □ □ □ GetFull, ReturnEmpty □ □ ) 

■ SMHEntry Point SMH REPORTEVENT 

2 . EVENT PLAYLISTCUEPOINT 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ CUE- 
POINT □ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
EVENT — PLAYLISTCUEPOINT, □ □□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□ EVENT ^ PLAYLISTCUEPOINTQ 

3 . EVENT PLAYLISTMESSAGE 

□ □□□ MESSAGE □□□□□□□ PLAYL- EVCB □ ulMessageParm □□□□ □ 

□ □ □ □ □ MESSAGE □□□□□□□(□□□□□ operand2)Q □□□□□□□ ulSta- 
tus □□□□□□□□□□□□□ 

A45 □□□□□□□□ 

□□□□□□□□□□□□□□□□ 

A46 □□□□□□□□□□ 

□ □□□□□□□ (SHC)D □□□□□□□□□ shc □□□□□□□□□□□□ 

□ □□□_ 2〇 □□□□□□□□□ □ 

1 . SHC- ASSOCIATE 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR INVALID - STREAM([] □□ hstream □□□ hstream □ hid □□□ ) 

■ ERROR INVALID OB JTYPE([] □□ ACBTYPE. MEM PLAYL) 

■ ERROR INVALID BUFFER. SIZE(ulAcbLen □□□□ ) 

■ ERROR — STREAM — NOT — STOP([] □□□□□□□□□□) 

■ ERROR INVALID BLOCK(D □ □ □ □ □ —— □□□/□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosQueryMem 

2 . SHC- CREATE 

□ □：□□□□□□ SPCBKEY □□□□□□□□□□□□□，□□□□□□□□ 
□ □□ DATATYPE. GENERIC □ SPCB[] □□□□□□ MEMSH 
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□ spcb .ulBufFlag □ □ □ □ □ SPCBBUF - USERPROVIDED □ □ □ 

□ □□□□□□□： 

■ ERROR INVALID, SPCBKEY 

■ ERROR ALLOC. RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosCreate Thread 

3 . SHC- DESTROY 

□ □□□□□□□： 

■ ERROR INVALID. STREAM([] □□ hstream □□□ hstream □ hid □□□ ) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

4 . SHC. START 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR — DATA - ITEM — NOT - SPECIFIED([] □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

5 . SHC. STOP 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR STREAM NOT STARTED 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosResumeThread 

■ DosSuspendThread 

6 . SHC. SEEK 

□ □:□□□□□□□□ SEEK — END □□□ ISeekPoint □ 0□□□□□□□□□ 

□ □□□□□□□□□，□□□□□□□□□□□□□□□□□□□，□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ LOOP □□□□□□ 

□ □□□□□□□□□□〇□ 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR NOT - SEEKABLE . BY . TIME 

■ ERROR DATA - ITEM NOT - SEEKABLE 

■ ERROR STREAM NOT STOP 

■ ERROR SEEK - BACK NOT SUPPORTED 
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■ ERROR SEEK PAST - END 

■ ERROR INVALID BLOCK 

■ ERROR PLAYLIST STACK OVERFLOW 

■ ERROR PLAYLIST STACK UNDERFLOW 

■ ERROR INVALID FUNCTION 

■ ERROR DATA. ITEM NOT SPECIFIED 

□ □□ API □□□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosQueryMem 

7 . SHC- GET PROTOCOL 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

8 . SHC. INSTALL PROTOCOL 

□ □：□□□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

■ ERROR ALLOC. RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

9 . SHC- ENUMERATE _ PROTOCOLS 

□ □□□□□□□： 

■ ERROR INSUFF BUFFER 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

10 . SHC. NEGOTIATE. RESULT 

□ □□□□□□□： 

■ ERROR — INVALID — STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR— INVALID— FUNCTIO_ □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

A47 □□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□ (SPCB), □ □ □ DATATYPE. GENER- 
ICQ □□□□□□□□□□□□ SPCBKEY □□□，□□□□□□□□□□□□□□ 
DATATYPE - GENERIC!] □□ SPCB □□□□□□□□□□□□□□□□□ intkey □ 
□ □□□□□□□□□□□□□□□□□□ SPCB □ □ A-2 □ □ 
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□ A^2 □□□□□□ SPCB 



SPCBD □ 


DATATYPE . GENERIC □ 


ulBufSize 


16KB 


ulMinBuf 


3 


ulMaxBuf 


10 


ulSrcStart 


1 


ulTgtStart 


1 


ulBufFlag 


SPCBBUF NONCONTIGUOUS 


ulHandFlag 


SPCBHAND- NOSYNC7 SPCBHAND PHYS- SEEK 



A48 □□□□□□ 

□ □□□□□(□□□□□□□□)□ 

A5 □□□-□□□□□□□□ 

□ □ 〇〇 0□□□□□□□□□ CD-DA(Compact DisoDigital Audio, 〇 

□ □，□□"□□□□□ ")U □□□□□□□□□□□□□□□□□□□□ (DAC)Q □ 
□，□□□□□□□□□□□□□□□□□□□□□ DAC □□ KB □□□□(□□ AC- 
PA □)□□□□□□□□, CI> DA □□□□ DLL □□□□□□□□□□□□□□ 

□ □□□□□，□□ CD □□□□□□□□□ 

□ □□□□□□□□□□ cd □□□□□□□□ cd-da □ cdddddd 2DDD 

□ □□，□□□□□□□□ CI>DAD □□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□ , CD-DA □ □□□□□□□□□□□□□□□ MMTIME 〇 □ □ □ □ 

□ □□□□□□□□□□□ CI>DA □□□□□□□□□□□□□□□□□ SpiSeek- 
Stream 〇 

□ □ 

A51 □□□□□□ 

■ □ □ □ CDDASH DLL 

■ □ □ □ □ CDDASH 

■ □ □ □ □ FILESYS 

■ PDD^ DLL DLL 

■ □ □□□□□□□□□□□□ 

□□□□□□□□□□□□□ 
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A52 □□□□□ 

□ □ 



A53 □□□□□ 

□ □□□□□ ACBTYPE- CDDA □□□□□□□□□ 



* CDDASH - CD DA Stream Handler Object ACB 




# define ACBTYPE. CDDA 


0x00 04 L / * Corrpact disc - 


digital audio */ 


typedef struct - acb. CDDA 
{ 

ULONG ulACBLen; 


/ * 


acbcdda - CD Assoc Control Block */ 


/ * 


Length of structure 


*/ 


ULONG ulObjType; 


/ * 


ACB. CDDA 


*/ 


CHAR bCDDrive; 
} ACB. CDDA; 


/ * 


CD drive letter 


*/ 



A54 □□□□□□□□ (EVENT. IMPLICIT . TYPE) 

□ □□□ CI>DA[1 □□□□□□ (EVENT— IMPLICIT — TYPE)[] □□□□□□ : 

1 . EVENT . ERROR 

□ □□□□□□□□□□□□□□□ (evcb)O ulFlagO □□□□□□□□□□□□ 
□ □ □ ： 

(!)□□□□ (TEMPORARY. ERROR OxOOOOL) 

□ □□□□□□□□□□□□□■□□□□□□/□□□□□□□□□□□[I/O 

□ □□□□□□□□□□□□□□ 

(2) □ □ □ □ □ (RECOVERABLE. ERROR 0x000 1L) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□ 

(3) □ □ □ □ □ □ (NONRECOYERABLE. ERROR 0x0002L) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ □ □ SpiDestroyStream □ □ □ 

ulStatus □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□： 

■ None 

□ □，□□□ API □□□□□□□□□： 

■ DosGetlnfoBlock 

■ SMHEntryPoint SMH NOTIFY 

■ DosDevIOCtl( □ ReadLong □□□ CD 〇 □□□□)□ 
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A55 □□□□□□□□ 

CD-DA □□□□□□□□□□□□□□ 

A56 □□□□□□□□□□ 

□ □□□□□□□ (SHC)D □□□□□□□□□ SHC □□□□□□□□□□□□ 
□ □□□_ 2[] □□□□□□□□□ □ 

1 . SHC. ASSOCIATE 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR — INVALID — STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR INVALID OBJTYPE([] □□ ACBTYPE. CDDA) 

■ ERROR INVALID BUFFER SIZE(ulAcbLen □□□□ ) 

■ ERROR — STREAM — NOT — STOP([] □□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosOpen(Q Q CD Q Q ) 

2 . SHC. CREATE 

□ □：□□□□□□□□□□□ 16 〇 PCM □□□，□□□□ 44 .lkHzQ 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

■ ERROR ALLOC - RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosCreate Thread 

3 . SHC. DESTROY 

□ □□□□□□□： 

■ ERROR INVALID — STREAM([] □□ hstream □□□ hstream □ hid □□□ ) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

4 . SHC. START 

□ □□□□□□□： 

■ ERROR INVALID STREAM([] □□ hstream □□□ hstream □ hid □□□ ) 

■ ERROR — DATA. ITEM — NOT — SPECIFIED([] □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

5 . SHC. STOP 
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■ ERROR INVALID - STREAM([] □□ hstream □□□ hstream □ hid □□□ ) 

■ ERROR STREAM NOT STARTED 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosResumeThread 

■ DosSuspendThread 

6 . SHC- SEEK 

□ □：□□□ SEEK □□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □ □ CD-DA □□□□□□□□□□□ 

□ □，□□□□□ SPCBQ □ □ □ mm time Per Uni t □ □ □ □ (granular)Q 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR DATA. ITEM NOT. SEEKABLE 

■ ERROR DATA - ITEM NOT - SPECIFIED 

■ ERROR STREAM NOT STOP 

■ ERROR SEEK PAST END 

■ ERROR SEEK. BEFORE. BEGINNING 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosDevIOCtl([] □ Seek- End □ Disk In fo □□ ) 

7 . SHC- GET PROTOCOL 

□ □□□□□□□： 

■ ERROR INVALID - SPCBKEY 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

8 . SHC— INSTALL PROTOCOL 

□ □：□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR INVALID. SPCBKEY 

■ ERROR ALLOC. RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

9 . SHC. ENUMERATE. PROTOCOLS 

□ □□□□□□□： 

■ ERROR INSUFF BUFFER 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

10 . SHC. NEGOTIATE. RESULT 
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□□□□□□□□: 

■ ERROR — INVALID — STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR— INVALID— FUNCTIO_ □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

A57 □□□□□□□□□□□□□□□□ 

CI>DA[] □□□□□□□□□ SPCB, □□□□□□□□□□ WAVE. FORMAT — 
4S16 □ DATATYPE. WAVEFORM：] □ SPCB □□□□ A-3 □□□□□□ 



□ A3 □ □ □ —— □□□□□□□□ SPCB 



SPCBQ □ 


DATATYPE . WAVE FOR M □ 


ulBufSize 


48KB 


ulMinBuf 


8 


ulMaxBuf 


12 


ulSrcStart 


1 


ulTgtStart 


7 


ulBufFlag 


SPCBBUF. FIXEDBUF 


ulHandFlag 


SPCBHAND- NOSYNG SPCBHAND- PHYS. SEEK 


ulBytesPerUnit 


588 


mmtimePerUnit 


10 



A5S □□□□□□ 

□ □□□□□(□□□□□□□□)□ 

A 6 CI>ROM XAD □ □ □ 

CD-ROM XA 

□ □□ CI>ROM XA □□□□□□□□□□□□,□□ CI>ROM XA □□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□，□□ , CD-ROM XA □□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□/□□□□□ 

AB1 □□□□□□ 

□ □ CD-ROM XA □□□□□□□□□□□□□： 

■ □ □ □ 



■ 268 ■ 



SSSH DLL 






















■ □ □ □ □ SSSH 

■ □ □ □ □ FILESYS 

■ PDD^ DLL DLL 

■ □ □□□□□□□□□□□□ 

□□□□□□□□□□□□□□ 



Aj62 □□□□□ 

□ □□□□ SHC- CREATE □□□□□□□□ DCB Q □ Q szDevName □ □ □ □ □ 
□ CD-ROM XA □□□□□□□□□ 



typedef struct - deb / * 

r 


deb - Device Control Block */ 


1 

ULONG 


ulDCBLen; 


/ * Length 〇 f structure */ 


SZ 


szDevName [MAX. SPI. NAME] ; 


/ * Device driver name */ 


} DCB; 






Aj63 □ □ 


□ □ □ 





□ □ 

ABA □□□□□□□□ (EVENT. IMPLICIT . TYPE) 

□ □□□ CI>ROMXA □□□□□□□□□ (EVENT — IMPLICIT — TYPE)[] □ □ 
□ □ ： 

1 . EVENT . ERROR 

□ □□□□□□□□□□□□□□□ (evcb)Q ulFlagQ □□□□□□□□□□□□ 
□ □ □ ： 

(!)□□□□ (TEMPOARY. ERROR OxOOOOL) 

□ □□□□□□□□□□□□□ 

(2) □ □ □ □ □ (RECOVERABLE. ERROR 0x000 1L) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

(3) □ □ □ □ □ □ (NONRECOVERABLE. ERROR 0x0002L) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □ SpiDestroyStream □ □ □ 

□ □□□□□□□ ulStatus □□□□□□□□□□□□□□□□□□□□□□□ 

□ ： 

■ None 

□ □，□□□ API □□□□□□□□□： 

■ DosRequestMutexSem 
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■ DosGetlnfoB locks 

■ SMHEntryPoint SMH NOTIFY 

■ DosDevIOCtl( □ ReadLong □□□ CD 〇〇〇〇〇〇 ) 



Aj65 □□□□□□□□ 

CI>ROM XA □□□□□□□□□□□□□□ 

Afifi □□□□□□□□□□ 

□ □□□□□□□ (SHC)D □□□□□□□□□ SHC □□□□□□□□□□□□ 

□ □□□_ 2 [] □□□□□□□□□ □ 

1 . SHC. ASSOCIATE 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR — INVALID — STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR INVALID OBJTYPE([] □□ ACBTYPE. SSSH) 

■ ERROR INVALID BUFFER SIZE(ulAcbLen □□□□ ) 

■ ERROR — STREAM — NOT — STOP([] □□□□□□□□□□) 

■ ERROR FILE. FORMAT INCORRECT([] □□□ cdxa □□ 2) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosDevIOCtl(CD[] □□□□ ReadLong) 

■ DosFSCtl(D □ CDFS) 

■ Dos Set FilePtr 

2 . SHC. CREATE 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□ SpiCreateStream API 

□ hstreambuf □□□□□□□□□ hstream □□□□□□□□□□□ CREATE □□ □ 

□ □□□□□□□□□□ (DCB)Q □□□□□□□□□□□□□ DCB □□□□□□□ 

□ □ □ □ □ 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

■ ERROR ALLOC. RESOURCES 

■ ERROR- TOO- MANY* STREAMS (□ □ XA □ □ □ □ □ 16 □ □ ) 

■ ERROR INVALID BUFFER SIZE(DCB □□ ) 

■ ERROR INVALID PARAMETER (DCB □□□□ ) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosCreate Thread 

■ □ □ CD □ □ □ □ DosOpen 
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3 . SHC. DESTROY 

□ □□□□□□□□ 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([] □□ hstream □ hid □□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

4 . SHC. START 

□ SHC. START □□□□□□□□□□□□□□,□□□ 

□ □ !/〇□□□□□□□□ 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([j □□ hstream □ hid □□□□□□□□) 

■ ERROR — DATA - ITEM — NOT - SPECIFIED([] □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

5 . SHC- STOP 

□ □：□□□□□□□□□□□□□，□□□□□□□ !/〇□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□，□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□： 

■ ERROR — INVALID. STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR STREAM NOT STARTED 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosResumeThread 

■ DosSuspendThread 

6 . SHC- SEEK 

□ □ : SEEK □□□□□□□□□□□□□□ SEEK □□□□□ ERROR— DATA — 
ITEM NOT SEEKABLEQ 

□ □□□□ SPCB □□□□ mmtimePerUnit □□□□ (granular ) 口 

□ □□□□□□□： 

■ ERROR — INVALID - STREAM([] □□ hstream □ hid □□□□□□□□) 

■ ERROR DAT A . ITEM NOT . SEEKABLE 

■ ERROR DAT A . ITEM NOT . SPECIFIED 

■ ERROR STREAM NOT STOP 

■ ERROR SEEK PAST END 

■ ERROR SEEK. BEFORE. BEGINNING 

■ ERROR LARGE . SEEK - BY TIME 
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□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

■ DosDevIOCtl( ReadLong □□□ CD Q Q Q Q Q Q ) 

7 . SHC. GET PROTOCOL 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

8 . SHC. INSTALL PROTOCOL 

□ □□□□□□□□□□□□□□ DATATYPE. CDXA. AUDIO, DA- 
TATYPE. CDXA. VIDEO □ DATATYPE. CDXA. DATA 〇 

□ □□□□□□□： 

■ ERROR INVALID SPCBKEY 

■ ERROR ALLOC. RESOURCES 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

9 . SHC. ENUMERATE. PROTOCOLS 

□ □□□□□□□： 

■ ERROR INSUFF BUFFER 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

10 . SHC. NEGOTIATE. RESULT 

□ □□□□□□□： 

■ ERROR — INVALID — STREAM([] □□ hstreamQhid □□□□□□ ) 

■ ERROR— INVALID— FUNCTIO_ □□□□□□□□□□□) 

□ □□ API □□□□□□□□□□： 

■ DosRequestMutexSem 

Afi7 □□□□□□□□□□□□□□□□ 

CI>ROM XA □□□□□□□□□ SPCB, □ □ A-4-Q A-7 Q □ 



□ A-4 CI>ROM XAQ □ □ □ SPCB: CDXA. LEVELB,CDXA. LEVEC 



SPCBD □ 


CDXA. LEVELBG 


CDXA. LEVELCD 


spcbkey .ulDataType 


DATATYPE - CDXA _ AUDIO 


DATATYPE _ CDXA _ AUDIO 


spcbkey .ulDataSubType 


CDXA. LEVELB 


CDXA _ LEV ELC 


ulDataFlag 


SPCBDATA. CUETIME 


SPCBDATA. CUETIME 


ulNumRec 


17 


17 
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□ □ 



SPCBD □ 


CDXA. LEVELB □ 


CDXA. LEVELCD 


ulBlockSize 


1 


1 


ulBufSize 


39984 


39984 


ulMinBuf 


8 


8 


ulMaxBuf 


16 


16 


ulSrcStart 


1 


1 


ulTgtStart 


1 


1 


ulBufFlag 


SPCBBUF- INTERLEAVED 


SPCBBUF- INTERLEAVED 


ulHandFlag 


SPCBHAND NOSYNC7 SPCBHAND PHYS- SEEK 


ulBytesPerU nit 


2304 


2304 


mmtimePerU nit 


160 


320 



□ A-5 CI>ROMXAD □ □ □ SPCB: LEVELB. MONO,LEVELC. MONO 



SPCBD □ 


LEVELB. MONO 口 


LEVELC. MONOD 


spcbkey .ulDataType 


DATATYPE. CDXA. AUDIO 


DATATYPE. CDXA. AUDIO 


spcbkey .ulDataSubType 


CDXA . LEVELB MONO 


CDXA. LEVELC. MONO 


ulDataFlag 


SPCBDATA. CUETIME 


SPCBDATA. CUETIME 


ulNumRec 


17 


17 


ulBlockSize 


1 


1 


ulBufSize 


39984 


39984 


ulMinBuf 


8 


8 


ulMaxBuf 


16 


16 


ulSrcStart 


1 


1 


ulTgtStart 


1 


1 


ulBufFlag 


SPCBBUF. INTERLEAVED 


SPCBBUF. INTERLEAVED 


ulHandFlag 


SPCBHAND- NOSYNC7 SPCBHAND PHYS- SEEK 


ulBytesPerU nit 


2304 


2304 


mmtimePerU nit 


320 


640 



■ 273 ■ 


































































□ A-6 CI>ROMXAD □ □ □ SPCB: CDXA. AUDIO. HD 



SPCBD □ 


CDXA. AUDIO G 


spcbkey .ulDataType 


DATATYPE. CDXA. AUDIO 


spcbkey .ulDataSubType 


CDXA. AUDIO HD 


ulDataFlag 


SPCBDATA. CUETIME 


ulNumRec 


17 


ulB locks ize 


1 


ulBufSize 


39984 


ulMinBuf 


8 


ulMaxBuf 


16 


ulSrcStart 


1 


ulTgtStart 


1 


ulBufFlag 


SPCBBUF- INTERLEAVED 


ulH and Flag 


SPCBHAND NOS YNC7 SPCBHAND PHYS- SEEK 


ulBytesPerUnit 


0 


mmtimeP er Unit 


0 



□ A-7 CI>ROM XA 〇 □ □ □ SPCB: CDXA- DATA, CDXA- VIDEO 



SPCBD □ 


CDXA. DATA □ 


CDXA. VI DEO □ 


spcbkey .ulDataType 


DATATYPE. CDXA. DATA 


DATATYPE. CDXA. VIDEO 


spcbkey .ulDataSubType 


0 


0 


ulNumRec 


17 


17 


uUBlockSize 


1 


1 


ulBufSize 


39984 


39984 


ulMinBuf 


8 


8 


ulMaxBuf 


16 


16 


ulSrcStart 


1 


1 


ulTgtStart 


1 


1 


ulBufFlag 


SPCBBUF. INTERLEAVED 


SPCBBUF. INTERLEAVED 


ulHandFlag 


SPCBHAND NOSYNC7 SPCBHAND- PHYS- SEEK 


ulBytesPerU nit 


0 


0 


mmtimePerU nit 


0 


0 
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Aj68 □□□□□□ 



□ □□□□□□□□□□□□□□□□ 15Q 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
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□ B-l P2STRING □ D □ □ 

□ □□□□□□□□□□□□□□□□□□□□□(□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□)□□□，□□□□□□□□□□□□□ 

□ □□□□□□□□□□ P2STRING .LOG □□□□ □ 

B1 □□□□□□□□□ 

□ □ □ P2STRINGQ □□□，□□□□□□□□□□□ P2STRINGD □ □ □ □ 

□ □□□□□□□□，□□□□□□□□ 1 〇 0 □ Times[] □□□□□□ B-2 〇 ,□□ □ 
□ ： 



□ □ B P2STRI NG □ □ 



□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ ) □ 
□ □ □ 
□ □ □ 
D □ □ 

o o o 
ip 



□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 



□ □ 
□ □ 
□ □ 



cr 



□ 

□ 



□ 



□ 



□ 

□ 

□ 



□ 

□ 

□ 



□ □ 

□ □ 

D D Gn 

3/2 D N 
w O RI 
T 



o 

□ □ 

2 

□ □ p 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
□ □ □ 
n G n 
g IN D 

m R □ 

R T 
T 2 

s p □ 
2 

p n □ 
□ □ 
□ □ 



□ 

\ ~ \ 

□ □ 
□ □ 
□ -1 

□ B 

□ □ 

□ □ 

/l\ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

ng 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



tr: 

s 

d 



□ 

□ 

I □ 



• cl 

me 



□ 

□ 

□ □ 
□ □ 
□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ □ 

□ □ 

□ □ 

□ □ 
n 

□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 
□ □ 

□ n 

□ □ 
,□ □ 

□ n 

□ n 

□ n 

□ n 
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SET P2STRING. FONTFACE = TIMES 
SET P2STRING. FONTSIZE = 10 

□ B-2 □□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□ FONTFACE □□ □ 
SYSTEM, COURIER, TIMES □ HELVETICA" (□□)□□□ □ FONTSIZE □□□ 8 
(□ □ ), 10,12,14Q 18Q 



B 2 □ □ P2STRING 



P2STRINGD □□□□□□□： P2STRING .EXE □ P2S . DLL .DLL[] □ □ □ □ □ 
□ □□□ \ TOOLKIT \ BIN \ BETA \ P2STRING □□□ B-3 □□□□□□□□□□ 
P2STRING □□□□□□□□□□□ B-1DD 



P2 STRING inp. file [ - a] out. file [ - eerr. file] [ - dl - D] [ - E] [ - t] 


□ B-3 P2STRINGD □ □ 

□ □：□□□□□□□□□□□□ 

□ B-l □ □ □ □ P2STRING □□□□□□□□ 

□ B^l P2STRINGD □ 


□ □ 


□ □ 


script- file 


□ □□□□□□□□□□□□□□ 

□ □：□□□□□□□□□□□□□□□□□□□□□□□□□ P2STRING Script 
Language 〇 P2STRING 〇 〇 〇 〇 □□)□ 


[ - a] out - file 


□ □□□□□□□□□□□□□□□□□□□□□□□□□[ - a], □□□□□□ 

□ □□□□□□□□□□□□□□□□,□□□□□□□ SAMPLE .SCR □□□ □ 

□ □□□□□□□□□□□ mdm .out □□□□□□□□ ,□□□ ： 

P2STRING SAMPLE .SCR - aMDM .OUT 


[ - eerr- file] 


□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□ MDM err □□□□□□□□： 

P2STRING SAMPLE .SCR MDM .OUT - eMDM .ERR 


[ - 4 _ D] 


□ □□□□□□□□□□□： 

■ - d □ □ P2STRINGD □□□□□□□□□□□□□□□□□□□□□□□ 

□ P2STRING □□□□□□□□□□□□□□□□□□ 

• -〇 □□□□□□ - (!□□,□□□□□□□□□□□□□□□□□□□□ 

□ □：□□□□□□□□□□□□□□□□□□□□(□□□□□□□)□□ 

□ □□□□□□ 
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□ □ 



- E 



□ □□□□□□□□□□□□□□□□□□□□□□□□□ SAMPLE .SCR □ □ 

□ ： 

P2STRING SAMPLE .SCR - aMDM .OUT - d - eMDM ERR - E 

□ □□□□□□□□□□□ MM— MCIPASSDEVICE □□□□ □ 



B 3 P2STRING □ □ □ □ □ (Script Language) 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□： 

■ □ □ 

■□□□□□ 

■ □□□□□□□□ 

■ □□□□□□□ 

■ □□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ B-4 □□□□□□□□□□□□□□□□ 

@ PROCESSES = 2 

@ EVENTS = {HASCTRLl= 1 , HAS CTRL2 = 0 } 

# 

# 

# 

@ PROCESS 1 

T 

; set masteraudio level for session to 1 0 % - will affect all 
; 3 processes 

r 

masteraudio volume 10 

T 

; open waveaudio device non- exclusively 

r 

open waveaudio alias wavl shareable notify 
+ MM- MCINOTIFY MCI - NOTIFY- SUCCESSFUL MCI - OPEN # 1 
@ WAIT- NOTIFY 1 60000 
@ WAIT— PASSDEVICE wavl 60000 
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@ WAIT. NOTIFY 21 60000 



□ B-4 □□□□□□□ 



□ □□□□□□□□□□□□□ ©PROCESSES □ @THREADSD 

□ □□□□□□□□□□□□□： 

■ Initialization([] □ □ ) 

■ Execution ([] [] ) 

B321 □□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □，□□□□□□□□□□□□□□□□□□□□□□□□□□ 

@ THREADS □ @ PROCESSES □□□□□□□□□□□□ ,P2STRING □□□ □ 

□ □□□ l 〇 □□□□□□□ 

□ B-2 □□□□□□□□□□□□□□ 



□ &2 □□□□□□ 



□ 


□ □ 


□ □ 


@ PROCESSES =x 




□ □□□□□□ 


□ □ 


□ □ □ □ 


□ □ □ 


□ □ 


(x)D □ □ 










@ PROCESSES = 


=2 














@ THREADS = x 


□ □□□□□□ 


□ □ 


□ □ □ □ 


□ □ □ 


□ □ 


(x)D 






@ EVENTS = {n[ = 


=0/ 1] [,n[ =0/ 1]]} 


□ □□□□□□ 


□ □ 


□ □ □ □ 


□ □ □ 


□ □ 


，□ □ □ 


15 □ 


□ 






□ □□□□□□ 


□ □ 


〇 □ ID 


□ □ □ 


□ □ 


@SET. 


EVENT 






□ □□□□□□ 


□ □ 




ID □ 


□ □ □ □ 


〇 □ 


□ 






□ □□□□□□ 


□ □ 


□ □ □ □ 


□ □ □ 


□ □ 


□ □ □ □ 


□ □ 


□ 






□ □□ 〇 □□□ 




















@ EVENTS = { brad = 


: 1 ，john = 


1 ， test = 


:0} 









B322 □□□□□ 

□ □□□□□□□□□□□□□□□□□□@ THREAD □ @ PROCESS □□□□ □ 
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□ M 

E 

□ R 
□ @ 

□ □ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

n 



3 

B 



□ 

□ 
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□ □ 
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□ 
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□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

/l\ 

□ 

□ 

□ 
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□ 

□ 

2 
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B 



□ 
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U U ij Li M iJ nameM □ □ □ IQ @WAIT. EVENT h U LI Li U 



□ D □ □ □ comment 

□ □ 



@ REM comment 



□ □□□□□□ alias □□□□□□□□□□□□□□□□ □口 

□ □□□□□□□□□□□□□□□□□□□ 20 □□□□ 

□ □：□□□□□ OPEN □□□□□□□□□□ 

□ □ (t 〇 )0 □□□□□□□□□□□□□□□,□□□□ 3 口 

□ □ 

P2STRING □□□□□□ OPEN □□□□□□□□□□□□□ 



@ WAIT - PASSDEVICE alias [to] 



□ □□□□□□□ MM- MCINOTIFY □□□□□□□□ □口 
(x)D □□□□□□ MM- MCINOTIFY □□□□□□□□□□ 

□ □□□ @WAIT. NOTIFY □□□□□□□□□□,□ □□口 

□ □□□□□□□□□□□□□□ 

□ □ (t 〇 )D □□□□□□□□□□□□□□□,□□□□ 3Q 

□ □ 

□ □□□□□ mciSendString □□□□，□□□□□□□□ □口 

□ □□□□□□□□□□□□□□□□ 

□ MM. MCINOTIFY □□□□□□□□□□□□ 口 

B3 .6 .in" (, n 



@ WAIT NOTIFY x[to] 



@ WAIT_ EVENT name[ to] 



u u □ name □□□ 〇 □ 1QD lUUUDUDDU.D 〇 □□ 

□ □□□□□□□□ 

□ □：□□□□□□□□□(§> EVENTS □ □ □ □ □ 



@ SET- EVENT name O 1 



□ @ PROCESS D □ □ □ □ 

□ □□□□□□□□□ xn 



@ PROCESS x 



□ thread □□□□□ □ 

□ □□□□□□□□ xn 



@ THREAD x 



□ □口 



□ □ □ □ 

□ B-3 □□□□□□□□□□□□□ 

□ @WAIT_ EVENT[] @WAIT— NOTIFY □□□□□□□□□□□□□ 口 

□ □ 

□ & 3 □ □ □ □ □ 



□ □ 

□ □ n 

□ □ n 

□□口 

□ □ 0 ) 

□ o (t 

□ □ n 

□ □ □ 
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□ □ 



□ □ □ 


□ □ 


@ PAUSE to 


□□□□□□□□□□ 
□□□□□□□□□□ 
□ □□□toDDDDD 


□□□□□□□□□□□□□□□□a 

□□□□□□□□□□□□□□□□a 

，□□□□□□ 


@ BREAK [message] 


□ □□□□□□□□□ message □□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□： 

@ BREAK [replace the CD] 


@CHEAK [message] 


□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□ messaged □□ Yes □ No □□□□□□□□□□□ 

□ □□ Yes 〇 □□□□□, 〇 □□□□□ No □□□□□□□： 
@ BREAK The music will play for 5 secs . Ready to time it ? 
play cdaudio notify 

@ PAUSE 5000 
@ CHECK Did it play ? 



B3 3 OS 2 〇 □□□□□□□ 

□ □□□□□□□□□□□□□□□□□ 〇 ^2DDDDDDDDDDDDDDD 

□ □□□□，□□□□□□ mciSendString □□□□□□□□□□□□ (MDM) 口 

□ □□□□□□□□□□□□□□□□□□□(□□ ?F00 ?□□)□□□□□□ 

□ □□□□□□□□□ mciSendString □□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□，□□□□□□□□□□□□□ NULLQ □□□□□□□□，□□ 

□ □ □ □ □ MMDATA □ □ □ □ \ DATA, 〇 open ? mmdata ? \ temp .wav alias ; 

□ □ □ open d^\ data \ temp .wav alias a 〇 

S3 A □□□□□□□□ 

□ □□□□□□□□□ 

□ □□□□□□□□□□□□□： 

= result 



status cdaudio ready wait 
= TRUE 

status cdaudio mode wait 
= stopped 



□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ : 
□ □ 
□ □ 

□ □ 



□ 

□ □ 

□ □ 
1 □ 

□ □ 

□ □ 

□ (□ 

□ □ 

□ □ 


- □ 
( □ 

□ □ 

□ □ 

□ 

□ 



n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 

n 
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□□□□□□□□□□□□□□ 

± i 〇 %D □□□□□□□□□□□□□□□□□□□□□□□□□： 

set f 〇〇 time format milliseconds wait 
play foo notify 
@ PAUSE 1000 
stop foo wait 
status foo position wait 
= 1000 

□ □,□□□□□□□□ 900-1100 □ □□□□□□□□□□□□□□□□□ 

B3 5 □□□□□□□ 

□ □□ □□□□□□□□□□ 

□□□□□□□□□□□□□□□□□□□： 

= ! error 

= !□□□□ !□□□□□□□□□□□□□□□□，□□□□□□□ ERRORD 

open sequencer alias mymidi wait 
loadmymidi nofile foo 
= ! File not found . 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□JO 

□□□□□□□□□□□□□□□□□□□□□□ 

B3 6 □□□□□□□ 



□ □ OS/2DDDDDDDDDDDDDDDDDD P2STRING □□□□□□□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□( + )□□□□□□□□□□□□□□□: 

■ □□□□/□□□□ 

■ □ □ □ □ 

■□□□□□□ 

□ □：□□□□ 〇 s/ □□□□□□□□□□□□□□□ 

□ □ 

B3 61 □□□□/□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□ MM - mcinotify 
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□□□□□□□□□□□□□□□□□□□: 

+ MM. MCINOTIFY notify - code message [ # x] 



□ □□□□□□□□□ B-4Q 

□ B^4 □□□□/□□□□ 



□ □ □ 


□ □ 


notify - code 


□ □□□□□□□,□□ MCI- NOTIFY. SUCCESSFUL] □□□□□ □ 
0S2ME _H □□□□# defines □□□□□□□□□□□□ 


message 


□ □□□□□□□□□□□□□□,□□ MCI. PLAYQ □□□□□□ 
OS2ME -HQ □ □ □ # defines 〇 □ □ □ □ □ MCI 〇 □ □ □ 


X 


□ □□□□□□□□ (x) □□□(§> WAIT. NOTIFY □□□□□□□□□□ 

□ □□□□□□□□□□□□□□，□□□□□□□□□□ 1-99 □□ □ 



B3B2 □ □ □ □ 

MM _ MCIPOSITIONCHANGE：] □□□□□□□□□□□□□□□□□□□□ 

□ ： 

+ MM. MCIPOSITIONCHANGE position % user- parameter #x 

□ □□□□□□□□□□□□□ B-5 〇 



□ B^5 □ □ □ □ 



□ □ □ 


□ □ 


position 


□ 


□ 


□ 


□ 


□ □ 


□ □ 


□ □□□□□ MMTIMED □ □ 


user - parameter 


□ 


□ 


□ 


□ 


□ □ 


□ □ 


□ □□□□□ SETPOSITIONADVISE □□□□□□□□ 




□ 


□ 


□ 


□ 


□ □ 


□ □ 


□ □□□□□□□□□ 1-99 □□□□□□□□□ 


X 


□ 


□ 


□ 


□ 


□ □ 


□ □ 


□ □□□□□ (x)D □□□□□□□□□□□□□□ B.3.7 




□ 


□ 




1 MM. 


MCIPOSITIONCHANGE □ □□□□"□ 



B363 □□□□□□ 

MM — MCICUEPOINT □□□□□□□□□□□□□□□□□□□□ message □ 

□ □□□□□□： 



+ MM. MCICUEPOINT position % user- parameter 



□ □□□□□□□□□□□□□ B-6Q 
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□ 


& 6 


□ □ □ □ 


□ □ 










□ □ □ 


□ □ 


position 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


MMTIME □ 〇 〇 










user- parameter 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


SETPOSITIONADVISE 


□ 


□ 


□ 


□ □ □ □ □ 




□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ 


□ □ 


□ □ □ 1-99 □ □ □ □ □ 


□ 


□ 


□ 


□ 



□□□□□□□□□□□□□□□□□□ 

B4 MM ■ MCIPOSITIONCHANGE □ □ □ □ □ 

□ □ □ P2STRING □□□□□□□□□□□□□□□□□□□□□□□ MM- 
MCIPOSITIONCHANGE 

□ P2STRINGD □□□□□□□□□□□(□□□□□□) 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□ SETPOSITIONADVISE □□□□□，□□□□□□□□□□□ 

□ □□□□□□/□□□□□□□□□□□□□□□□□□□□□□□□□ MMTIME 

□ 

□ □□□□□ (play) □□□ (seek)Q □□ (record)!] □□□□□□□□□,□ P2STRING 

□ □□□□□□□□ ( position- advises )□ □□□，□□□□□□□□ SETPOSITIONAD- 
VISE □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□，□□□□□□□□□□□ 

□ □ ： 

setpositionadvise SomeDevice every 10000 on return 5 
+ MM- MCIPOSITIONCHANGE 10000 % 5 

play SomeDevice from 3 5000 to 55000 notify (produce 3 posit ionc hange msgs) 
seek SomeDevice to 30000 wait 

play SomeDevice notify (produces a number of messages starting at 30000) 

MM — MCIPOSITIONCHANGE 

□ □□□□□□□□□□□□□□□□□□□□□□□□ MM- MCIPOSI- 
TIONCHANGE □ □，□□□□□□□□□□□□□□□□□□□□□ SETPOSITION- 
ADVISE □ □ □ □ 

□ □ ： 

setpositionadvise SomeDevice every 10000 on return 5 
+ MM- MCIPOSITIONCHANGE 10000 % 5 

play SomeDevice from 35000 to 55000 notify (produce 3 positionchange msgs) 
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setpositionadvise SomeDevice every 10000 off 
seek SomeDevice to 30000 wait 

setpositionadvise SomeDevice every 10000 on return 6 
+ MM- MCIPOSITIQNCHANGE 10000 % 6 

play SomeDevice notify (produce a number of messages starting at 30000) 



B5 □ □ □ □ 

□ □□□□□□□□□DO 〇 □ !□□□□□□□ 〇 □ 3DDDDDDDDD 
□ □□□□"□□"，□□□□□□□□□□□□□□□□□□□□□□□□□□□[ 
□□□□□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□ 

□ ,□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

mdm □□□□□□□□□□□□□□□□□□□□□□□□□□□□,□□ 

□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
mciSendString □□□□□□□□□□□□□□□□□□□□□□□□□□□□[ 
ERROR □□□,□□□□□□□□□□□□□□ mciSendString □□□□□□□□ 

□ □□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□，□□□□ 

□ □□□□□□□□□□□□□□□ mciGetError □□□□□□□□□，□□□□[ 

ERROR, □ □□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□，□□□□□□□□□□，□□□□□□□□□□□□□□□□□□□□□ 
□，□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 
□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□，□□□□□□□□□□□□□□□□，□□□□□□□□□□□□□□□□□ 

NOTIFY . SUCCESSFUL NOTIFY - ERROR □□,□□□ □ 

□ □□□□□ NOTIFY- SUCCESSFUL, NOTIFY— ABORTED □口 NOTIFY _ 
PERCEDEDQ □□□□□□□□□□□□□□□□□□□，□□□□□□□□□□ 

□ NOTIFY^ ERROR □□□,□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□ 



□ □ 

] □ , 
□ □ 

□ □ 

□ □ 

] = ! 
□ □ 

□ □ 

] □ ! 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 
SU- 
□ □ 

□ □ 
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] □ C □ [ 



□ □□□□□ IBM □□□]□□□□□□□□□□□□ IBM □□□□□□□□□ 

□ IBM □□□□□□□□□□□ IBM □□□□□□□□□□□□□□□□□□□□□ 

□ □□□ IBM □□：□□□□□□□□□□□□□□□□ □□□□□□，□□□□□ IBM 

□ □□□□□□□□□□□□□□，□□□□□□□□ IBM □□□□□□□□□□□□ 

□ □ IBM □□□□□□□,□□□□□□□ □□□□□□□□□□□□□□□□□□□ 

□ □ □ 

IBM □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□□ 

□ □□□，□ □ ： IBM Director of Licensing, IBM Corporation, 500 Colubus Avenue, 

Thornwood NY 10594, U .S AD 
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□ □□□□□□□□□□□□(*)□□□□ IBM □□□□□□□□□□□□□： 

Audio Visual Connection 

IBM 

Common User Access 
CUA 

Multimedia Presentation Managed 2 
OS/ 2 

Presentation Manager 
Workplace Shell 

□ □□□□□□□□□□□ 

Helvetica Linotype Company 

Pro AudioSpectrum 16 Media Vision, Inc . 

Sound Blaster Creative Labs, Inc . 
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